Dragon Age: Origins (DAO) 


From Woe to Go: 
How to make a mod using the DAO toolset 


Stephen Karpinskyj (WeVEn) and Anna Tito (MythicalC) 


This tutorial set was originally developed by us for the RMIT Games Studio 1 Class. You will notice two very 
different styles of tutorials in this series. The Art and Design side of the toolset has been covered by Anna 
and the Programming and Technical 101 side has been covered by Stephen. 


We would like to thank the builders of the Dragon Age Wiki for all the resources they have supplied as well 


as the numerous members of the modding community who have written or recorded fantastic DAO tutori- 
als. 


If you have any questions, feedback or notice any errors please let us know by e-mailing Anna at 
anna.tito@mythicalcreature.net. 


Have fun modding © 


Table of Contents 


INTRODUCTION rc REUTERS 5 
Important RESOULCES tise ii scaesasetus di id IRE Racial 5 
Iristalling THE: Ton Sy E tie Eid tt du eeu rede E eds 5 
File.Narming:ConventioDss eerte ca 6 

Resource Naming ConventiOn..................eeeeeeseeeeeeee eene eene nennen nennen nenas aaas states esses sese E aiaia edadea 6 
Database Introduction eicere te iE De ii eh e cate boc el S d E ie 7 
Manage your resources in the databasSe.........occcccconnononoonnnnonnnnnnnnnannnnnnnonononnnnnnnnnnnno non inanis nasse sse iaaa 7 
File system and Resource Introduction & Submitting Modules..................... esses nennen 8 
Understanding the DA:O filesysteM.....ooooooooocccnnncncononanononnnnnnnnnnnnnnnanono non nnnnnn nates enn en tetris asas asas ss eser nasi ananas 8 
Understanding DA:O resources.............sesssesessesesee senes aree aAa E nas aE senses setas isa assa asses esses stagna nas 9 
Using the "Builder to Builder" tools .............oococccconnnoooonooonononnncnnnnnonnnonononnnnnnnnnnnnnnnnnn ea adean 10 
Using the "Builder to Player" tool ..........cccccsccccccccscsssesssncseeceseceecesseeseaeaaeaeeeeseceseeeseeaaeaeeeeeeessesseeseaaaaeess 11 
Submitting your MO ui a 12 

cea cari rot 13 

Scripting Tutorial 1 — Scripting Intro ......cccconnnnocuononnncnnnncnnnnnnnnnnnnnnonnnnnnnnnnnnnnonnnnnnnnnnonnnnnnnnnnnn nro nnnnnnnnnnnanananenns 13 
Create'a new testimodule:...... iie Rete a as 13 
Create anew ACCIPIET 13 
Create a starting point for your module ............cccccsscecececcessesseseeaecseceeecescesseeseeaeaaeceeeeeseuseseseensaaaaeeeeeeesens 14 
Playtest your module: ias 15 
Create:a new test script. uiid eee liada 15 
Compile your NEW test: Script 5d A av xd tip ved té uae evsd ves ey eden d itte vend 16 
Make your new test script do something................ sess eene enne nen nn nan nn nsns enn n nein annis 16 
aC IUE 16 

Scripting Tutorial 2 — Scripting EVenNtS....ccoconcnnoooonoonconnnncnnnnanonononnnoncnnnnnnnnnnnnononnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnncnnannnanenns 17 
Duplicate an existing creature template .........cccccocnnnonooooncnncnnncnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn cnn nnnnnnnnnnnannnanennnonanons 17 
Instance and customise your new creature template..........cccccccononooooonnnnnnncnnnnnnnnananononnnnnonnnonanananonononannns 18 
Create a new event-handling script ........cccccconcononoonononononnnnnnononanononnnnnnnocnnnnananononnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnns 19 
Make your new event-handling script do something more exciting..................... esee 20 

Scripting Tutorial 3 — Object Variables and 2DA'S .......... liess nennen nennen nnns nnns esee enia 21 
Set üp yoür area arid resource siti dst ec tesesi is 21 
Write Your trigger Script. icio sicco pua cota e oa aana E EOD a py PREN ava cada aa 22 
Create a new variable 2DA file siii aiiin eiaa aa i a cnn enhn sente nen ia sentent a eaaa 23 
Compile a2 DA SI "cR 23 


BEE-wicr wl "ER 24 


LOST Cio pr ES 25 
Scripting Tutorial 4 — Problem Solving ...........cccccscssccceceeceseeseesseeaeeeeeeeeceseeeseaeaaeeeeeeeeenseeseesaeaaeaeeeeeeeseeseegeas 26 
Mile: CH alle AB etx. ii m e Da e vtta ee e D eto UM 26 
Scripting Tutorial 5 — Problem Solving Solution and M2DA'S.......ccccccnnnnnnnonononnnnnnononnnnnnnananonnnnnnnnnnnconanannnonns 27 
Solution to the challenge cian ene EA Rai 27 
Adding a reli ————ÁÁ——— —H— 29 
ART & asc ———— Aa 30 
Tütotial 1.5 Introduction ra entr A ta 30 
A ihe E a eed pue a ern i e ees 30 
KATH id 33 
Tutorial 2 — Exteriors, Water, Vegetation and MoOdelS.........cccconnnnoooononcnonnnnnconanannnnnonnnnnnnncnnonnnnnn ono nnonnnnncnnnns 38 
inei P EHE 38 
Editing Terrain xiu vec da idas 42 
Terrain Textüring:zi ie ier cete adatta a Dd ey Ta ve de dE a DR a Qua d ERR 42 
rica EE 43 
Making amExpotrtable Area... n pde ort e atit fe e Ae E v ee a daa RR ceeds 43 
Water'-:'Part2..— nei t e A taut ita We tete dta te ener ida 44 
VESItATON tue ec e ed teat eer caeco er oo ed e Dre Er xg La DERE Re Eb ceva ie y pee eta 44 
Lighting: eee tere de hh o eet fecistis Patito e Ae e v e RN sees 45 
Models —————M—Á————————— — Rane 45 
Tutorial 3 Path finding, Exporting Levels, Areas, Props & Items ................ eese enne 46 
hrs € 50 
Tutorial 04 - Area Transitions, Conversations Part1............. sss eene nnhen nennen rehenes skate nna 53 
Area'TransitiOris a a a a a a a a a 53 
Conversation cmm 54 
DA Conversations: Odia ió 54 
Writing thé Conversation. iiie edite evene en as eden tabe tede aede a Ex eR Avo e cidcid 56 
Conditions: S; ACLIOTIS aid 58 
dh rp EM 59 
SO cf p I ———————————É——————————— Á'— — 60 
Tutorial: 05... tre re ette erre Eee RR BUR re Da ade ad aiii 61 
Wis Wal EFFECTS cases: ER 61 
Creatures: Se Characters: «scd ARS A a 62 


Waypoints & Ambient Behaviours .......ccccccccccnnnnnnnnononnnnnnnnonnnnnnnnnnnononnnnnnnnnnnnnnnnnr non nnnnnannnnnnnnnnnnnnnnnnnnnannnnnnnns 66 


Ambient: Walking nen —————————————— 66 
A AE 67 
Conversations Part 2: iine e rte e p o dae 68 
MITOS IET 68 
CUTSCENES eels oie. D 73 
Cüt Scenes: aL TEE 75 
Creatures and; Cut SCernes: un rt er PER a SER RU UAE EISE a 76 
Adding tlie Player: a aide eee i ics 77 


INTRODUCTION 


Important Resources 


e Dragon Age Builder Wiki: 
http://social.bioware.com/wiki/datoolset/index.php/Main Page 


e BioWare Social Network Particularly the DA:Builder Utilities Projects 
http://social.bioware.com/browse_bw_projects.php?page_num=1&project_search=Search&view= 


O&project_category_id=6&sort=1 
e YouTube video tutorials particularly those by the following users: 
o dragonage22, link to Tutorial 1: http://youtu.be/DKJ7F14n808 


o St4rdog, link to Tutorial 1:http://youtu.be/TwQNRBFLhrE 


Installing the Toolset 


If you want the toolset at home, you will need a buy a copy of the game and register it with a BioWare ac- 


count, you can then download the toolset (http://social.bioware.com/page/da-toolset). 
There are a few tricks to getting the mod installed and fully working. 


1. Make sure you install all the recommended files, the toolset is very version specific and you 
will need to make sure the right version of Microsoft SQL Server Express and all the Core 
Resources are installed. 
2. For light mapping and level exporting to work you will need: 
a. Python 2.5.4 available here: http://www.python.org/ftp/python/2.5.4/python- 
2.5.4.msi 
b. The win32 extensions for Python 2.5 available here 
http://sourceforge.net/projects/pywin32/files/pywin32/Build%20214/pywin32- 
214.win32-py2.5.exe/download 
OR 
The ActiveState Python 2.5.5.7 available here: 
http://downloads.activestate.com/ActivePython/releases/2.5.5.7/ActivePython- 
2.5.5.7-win32-x86.msi 
| personally Used the win32 extensions and it worked fine, | installed it as all 32bit because it can have issue 
with the 64. The DA Builder Wiki has an excellent 'How to' and known bugs and solutions section see: 


http://social.bioware.com/wiki/datoolset/index.php/Installing the toolset 


File Naming Convention 


DA: O has a very strong resource and module naming convention, it is a good idea to follow it when build- 
ing your mod. You can find the documentation on naming conventions here: 
http://social.bioware.com/wiki/datoolset/index.php/Naming conventions 


Resource Naming Convention 
Naming conventions information from the DA Builders Wiki (link above): 


cir200cr. bloodmage 


1. Thethree letter prefix (green) in this case "cir," this indicates which large scale area the object is 
from in your case it will be your mod prefix e.g. My mod was called "A Little Red" so we would use 
the prefix "alr" for our files. However in a larger mod you may want to use a set prefix for a cer- 
tain area or quest tree. For instance if you have a section of the game that is in mines then using 
'min' as a prefix would help you to separate out your assets. There are a number of prefixes al- 
ready in use which you can see on the Prefixes in use page on the DA Builders Wiki, It is important 
not to use any of these as it will cause conflicts with the Core resources of the Game or its expan- 
sions and modules: http://social.bioware.com/wiki/datoolset/index.php/Prefixes in use 

2. three-digit number unique to a particular area, generally starting with 100 and incrementing in 
hundreds for major areas. Accessory areas are given numbers within the block of one hundred 
(usually multiples of 10) that their 'parent' area belongs to. "global" resources are often given the 
number 000. E.g. if you had a chair for your castle level and the castle was "alr100ar Castle" then 
your chair would be alr110ip Chair, this tells you that it is a Chair placeable , in the castle area of 
the mod "A Little Red". 

3. two-letter code indicating what general type of resource it is ("ar" for area, "al" for area list, "ip" 
for placeable, "cr" for creature, "im" for item, "tr" for trigger, "pt" for plot, "st" for stage, "cs" for 
cutscene, "wp" for waypoint). A major exception here is event scripts, which have exactly the 
same name as the resource they're the script for. Dialogue files are also generally named exactly 
the same as their owner resource. Merchants usually have the owner name, with the prefix 
"store ". 

An underscore. 
5. The remainder of the name is free-form and human-readable, a descriptive term to remind you at 


a glance what the resource is. 


If you are looking at developing your own models, voice over, animation or vegetation for your mod there 
are also specific model naming conventions for each of these object types which you can find on the Nam- 


ing Conventions page listed above. 


Database Introduction 


This week you will be learning how the DA:O resource database works so that you can store and delete all 
of your resources (e.g., areas, scripts, creature templates, etc). 


Manage your resources in the database 
Most of the ways that you can manage your module's resources in the Dragon Age database (e.g., check 
in/out, delete, undo, etc). 


Resources that you create in the toolset are automatically added to your computer's copy of the 
Dragon Age resource database. Resources must be checked out of the database before they can 
be edited. New resources are, by default, "checked out". 


If you are sharing a database, only one person can have a checked out/editable copy of a re- 
source at any one time. 


1. Check out one of your resources from the database by right-clicking on it in the "Palette Window" 


and selecting "Check Out" (its icon will now look like). 


Once you have finished editing a new version of a checked out resource, it can be "checked in" 
again (i.e., the database will be updated with your new version and you can only view a read- 
only copy of the resource). 


2. Check in one of your resources that has already been checked out by right-clicking on it in the "Pal- 


ette Window" and selecting "Check In" (its icon will now look like 8 ). 


The changes made to checked out resource can also be "undone" (i.e., any changes you made to 
the resource since it was last checked out will be lost and the resource will become checked in 
again). 


Undoing a checkout is permanent! Once you undo your changes, they're really gone! 


Undo all changes to a resource since it has been last checked out by right-clicking on it in the "Pal- 
ette Window" and selecting "Undo Checkout". 


be undone before the delete option becomes available. 


Delete one of your resources from the database by making sure it is checked in (i.e., its icon looks 


like 8 ) and right-clicking on it in the "Palette Window" and selecting "Delete". 


To look at a history of resources that you have deleted, select "Tools => Deleted Resources" from 
the top menu bar. 


3. 
T A checked out copy of your resource cannot be deleted, your edited copy must be checked in or 
4 
5. 


View changes between your currently edited version and the last checked in version by right- 
clicking on it in the "Palette Window" and selecting "Diff to Last Checked In". 


6. View the change history of one of your resources by right-clicking on it in the "Palette Window" 
and selecting "Resource History". 


T You can also open and edit a "local copy" of a resource. These are always separated from the 
database and any changes made to a local copy are not saved if the toolset is closed. 


7. Open a local copy of one of your resources by making sure it is checked in (i.e., its icon looks like 8) 
and right-clicking on it in the "Palette Window" and selecting "Open Local Copy". 


The purpose of using a database to manage resources is twofold: 1) prevent team members from 
T) overwriting each other's changes and 2) protect a working copy of your work from any experi- 


mention or file corruption. 


You've finished the database introduction and learnt how to add, edit, update and delete 
resources using database terminology such as check in, check out and undo. If any or all of 
the above wasn't clear, see the builder wiki's brief explanation of checking in/out (link) or 
ask questions in class, this is important stuff! 


File system and Resource Introduction & Submitting 
Modules 


This week you will be learning where to place all of your resources, whether they are uncompiled or com- 
piled as well as defining what uncompiled, compiled, designer, art and 2DA resources are. 


A The point of this tutorial is so you can use the "Builder to Builder" and "Builder to Player" tools 
to submit your modules as part of your assignments. 


Understanding the DA:O filesystem 


In order to better understand where you should place special files that you add to your module or to load 
other modules, you need to get to know the convoluted Dragon Age file system. 


Your "module folder" is automatically created when you add a module in the toolset and is named 
after your module's "UID" property. It is located in your current Windows profile's "My Docu- 
ments" or "Documents" folder: 

"<Documents> \ BioWare \ Dragon Age V Addins Vy «Module Name?" 


Your "module's override folder" is where you should place all compiled assets that you wish to 
add or use to overwrite existing assets (e.g., exported level layouts, .GDA files, etc). Resources 
placed here can be read by your module (including when your module is open in the toolset) but 


not by other modules (including when another module is open in the toolset). It is located in 
your module folder: 
"«Module Folder» \ module \ override" 


Your "module's assets folders" are where you should place all uncompiled resources (e.g., un- 
compiled art, sound or 2DA assets (e.g., unexported levels, .WAV files, .XLS files, etc). This is not 
required but will make it much easier to create a package of all your work when submitting your 
assignments. This set of folders are located in your module folder: 

"«Module Folder» \ assets \ 2da" 

"«Module Folder»? \ assets V art" 

"«Module Folder» \ assets V sound" 


Your "Windows profile's override folder" is where module files (.DAZIP packages) are placed when 
installed (see section 4). Other compiled resources can be copied here if you want them to be ac- 


© 


cessible from any module. Itis located in your "My Documents" or "Documents": 
"<Documents> \ BioWare \ Dragon Age \ packages \ core \ override" 


It is not as important to know what other override folders are used for so don't read the follow- 
ing explanations unless you're really keen! 


Your "module's core override folder" is where you place resources that you wish to be accessible 
from the current module and other modules. This folder is used for resources that have the "Own- 


eb 


er Module" property set as "Core" instead of the current module. This is because not all modules 
are standalone campaigns, sometimes they are modifications for other campaigns, including the official 
single-player campaign. You can disable/enable the effect of modules in the DA:O main menu by selecting 
"Downloadable Content => Installed Content"! It is located in your module folder: 


"«Module Folder? \ core V override" 


Your "computer's override folder" is exactly the same as your Windows profile's override folder 
except that it affects all Windows profiles, not just the current. It is located in the DA:O install di- 
rectory: 

"«DA:O Install Directory» XV packages \ core V override" 


Understanding DA:O resources 
Resources that you create inside the toolset (e.g., scripts, areas, levels, 2DA's, etc) or outside the toolset 
(e.g., textures, models, GDA's) are either compiled or uncompiled. 


You should place all resources in their correct place as explained during this section! 
The term uncompiled resources applies to "raw" or "source" resources that have not yet gone 


through a conversion process and can generally, but not always, be opened with programs other 
than the toolset (e.g., .WAV, .XLS files). 


eb 


The term compiled resources applies to "exported" or "built" resources that either the toolset, 
external applications (e.g., FMOD) or a plugin for other applications (e.g., 3D Studio Max) con- 
verts to another filetype that is optimised to be quickly loaded into your computer's memory 
and read by DA:O. 


However, not all resources need to be compiled and are supported by the toolset in their native 
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format (e.g., .DDS is a supported texture format that can also be edited in Adobe Photoshop, GIMP, 
etc). See the builder wiki for more info on .DDS files (link). 


In order to create custom content for your modules you are nearly always going to have to follow a re- 
source compilation processes of some kind. Some common processes are as follows: 


1. Using the toolset to export level files (.LVL) as area layouts. 


2. Using FMOD to convert a project of uncompiled .WAV audio files into compiled .FSB/.FEV files. See 
the builder wiki for more info (link). 


‘As far as | know, this is the difference between the Window's profile override folder and a module's core override 
folder. Although they both affect more than a particular module, you can't disable/enable modifications if they 
are added to the Window's profile override folder and therefore not associated with a particular module. 


3. Using ExcelProcessor to convert uncompiled .XLS 2DA files into compiled .GDA files. See the builder 
wiki for more info (link). 


4. Using a plugin for 3D Studio Max to export meshes as .MMH/.MSH files. See the builder wiki for 
more info (link). 


Resources generally fall into one of the following 3 categories: 


1. "Designer resources" are always created and edited in the toolset (e.g., areas, item templates, 

creature templates, trigger templates, etc). When you create new or override existing designers re- 

sources in the toolset, they primarily exist in your computer's DA:O database and don't have an un- 
compiled form. For more info, see the builder wiki (link). 


2. "Art resources" form the physical aspect (i.e., appearance/sound) of designer resources like 
T) models, animations, etc (e.g., A designer resource such as an item is a model plus a set of edita- 


ble properties. You must place all your compiled art resources in your module's override folder 


(e.g., MM). For more info, see the builder wiki (link). 


It is strongly recommended that all uncompiled art resources are placed in your module's art as- 
A set directory (see section 1). This is not required but will make your work easier to package for 
submission. 


visual effects). You must place all your compiled 2DA resources in your module's override folder 


3. "2DA resources" form the data that is often either attached to designer resources (e.g., a 
T) trigger template has an attached variable 2DA) or used to reference art resources (e.g., a list of 
(e.g., ".GDA" files). For more info, see the builder wiki (link). 


It is strongly recommended that all uncompiled 2DA resources are placed in your module's 2DA 
A asset directory (see section 1). This is not required but will make your work easier to package for 
submission. 


Lastly, your are likely to end up with a lot of resources in your module's override folder so you have 2 ways 
of keeping them neat and tidy: 


1. Subfolders can be placed into your override folder (e.g., a subfolder to place 2DA files, another 
for voice-over files, etc). 
T 2. .ERF files are resource packages that the toolset can create/extract and DA:O will read. You can 


package up your resources (e.g., a package for your creatures, etc). See the builder wiki for more 
uses for .ERF's (link). 


Using the "Builder to Builder" tools 
The steps you need to take to package some/all of your module's uncompiled resources so that they can be 
transferred to another computer's resource database. 


home/uni or pass your work to your teammates) you will need to use the toolset's "Builder to 
Builder Create" tool. 


o In order to transfer your uncompiled resources from one computer to another (i.e., transfer to 
. In the "Palette Window", highlight the resources you wish to transfer to another computer. 


Right-click the selected resources and select "Tools => Builder => Builder to Builder Create". 
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Press "Ok" in the "Builder to Builder Create" tool to open the "Save As" dialog box. 
Find a place on your computer to store your work, name the package and press "Save". 


In order to add uncompiled resources from another computer (i.e., transfer from home/uni or 


load your teammate's work) you will need to use the toolset's "Builder to Builder Load" tool. 
Select "Tools => Builder => Builder to Builder Load" in the top menu bar to open the tool. 
Find the package (.DADBDATA file) you want to load (e.g., on a USB drive) and press "Open". 


Check/tick the boxes of the resources you wish to import into your database and press "Ok". This 


will either add a new resource to the database or overwrite the checked in version of an existing resource. 


OF © © 


The "Builder to Builder Load" tool won't automatically check in the resource that you imported if 
it is a resource that already exists in the database. It is up to you whether you check in a file to 
your database after importing an existing resource. 


You can press "Check In Resource" from within the "Builder to Builder Load" tool if you want to 
update one or more of your resources in the database before you overwrite it. 


Make sure "Create New" from the "StringlDs" section of the "Builder to Builder Load" tool is se- 
lected. This will avoid a toolset bug that often doesn't load resources correctly but it's a big pain 
to remember when "Use Theirs" is always selected by default! 


For more information on the "Builder to Builder" tools, see the builder wiki (link). 


Using the "Builder to Player" tool 
The steps you need to take to package a compiled version of your module so that it can be played on an- 


other computer. 


MEE — 
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In order to transfer a playable version of your module's resources (i.e., compiled resources) you 
should use the toolset's "Builder to Player Package" tool. 


Open the Dragon Age Toolset and make sure your module is open. 
In the top menu bar, select "Tools => Builder => Builder to Player Package". 
When prompted to open a "user manifest", either select a previous one or press "Cancel". 


In the "Builder to Player Package" dialog, select your module files. If you have kept all your module 
resources in your module's directory (see section 1) then this involves unselecting all files and only 
checking your module folder. 


With all your module files checked, press "Ok" to open the "Save As" dialog box. 
Select a directory and name for your module package and press "Save". 


You have the option to save a user manifest (i.e., xml file containing filenames and directories) of 
the files you just added to your module package. 


You can open this user manifest in future to automatically check the same list of module re- 
sources. 


For more info on the "Builder to Player" tool, see the builder wiki (link). 


To install a module package (i.e., a .DAZIP file), open the "DAUpdater" application found in "«DA:O 
Install Directory» X bin. ship". 
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9. Press the "Select DAZips" button, browse your computer for the module package to install and 
press "Open" to go back to the DAUpdater application. 


10. Select that same module package from the module list and press "Install Selected". 


DAUpdater will, amongst other things, copy the new module to your Windows profile's override 
folder (for more info, see section 1). 


Submitting your modules 
The steps you will need to take to submit both an uncompiled and compiled version of all your module's 


resources for future assignments. 


Unfortunately there is no one-step method for packaging all re- 
sources required for submission. The method below is still quite te- 
dious and easy to stuff up! 


1. Create a package of your module's uncompiled designer resources by selecting all your designer 


resources in the toolset's palette window, right-clicking them and selecting "Builder to Builder Cre- 
ate" (see section 3 for how to use the "Builder to Builder Create" tool). The tool will produce a 
.DADBDATA file for you to include in your submission. 


2. Create a package of your module's uncompiled art and 2DA resources by adding them all to a .zip 


file. If you followed previous advice, all these resources should be in your module's assets folders 
(see section 1 and 2). Add all the assets folders (2DA, art and sound) to a ZIP file and name it as 
"assets.zip" or similar. 


A To make doubly sure your submission contains everything, we recommend zipping up your en- 
tire module folder, and not just the assets folder. 


3. Create a package of all your module's compiled resources (designer, art and 2DA) by exporting the 


latest version of your resources in the toolset” and using the Builder to Player tool to create a pack- 
age that includes all your playable module files (see section 4 for how to use the "Builder to Player" 
tool). The tool will produce a .DAZIP file for you to include in your submission. 


4. When submitting, make sure you have copied all of the following files to your disc: 
* «Module Name>.dadbdata 
e Asset folders or entire module folder (.ZIP) 
e «Module Name>.dazip 


e Design document (.PDF) 


“See scripting tutorial 2, section 4 if you're not sure what "exporting resources" means. 
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SCRIPTING 


Scripting Tutorial 1 - Scripting Intro 


This week you will be learning how to set up a new module with a test area in the Dragon Age Toolset and 


then attach a basic script to your area. 


Create a new test module 


The basics steps you will need to take to create a new test module once you have installed the Dragon Age 


Toolset. 
1. Open the Dragon Age Toolset. 
2. Inthe top menu bar, select "File => Manage Modules". 


3. Inthe "Manage Modules" dialog box, select "New..." to open the "Object Inspector" dialog box (i.e., 
the properties of your new mod). 


4. Enter the title of your new module into both the "Name" and "UID" fields (e.g., "Tutorials") and 
click "OK". 


5. Back in the "Manage Modules" dialog box, choose your new module from the list and click "Open". 
T For an advanced look at creating modules, check out the official wiki's page (link). 


A Deleting a module is not easy and can be a real pain (link) so keep that in mind before creating 
lots of test modules. 


Create a new test area 


The steps you will need to take to quickly create an area for testing out your scripts once you have created 


and opened your new test module. 


1. Open the Dragon Age Toolset and make sure your your new module is open. 


To see which module the toolset has open, look at the end of title bar (very top-left of the tool- 
T set screen). It will read "Dragon Age Toolset v1.0... - «Module Name»". 


2. Remember if your module is not open, select "File => Manage Modules" in the top menu bar, 
choose your module from the list in the "Manage Modules" dialog box and click "Open". 


3. In the top menu, select "File => New => Area" to open the "Create New Resource" dialog box. 
4. Enter the name of your test area into the "Resource Name" field (e.g., "scriptingarea"). 
5. Create a folder to store all of your module's resources by entering a new folder name into the 


"Folder" field (e.g., "\Tutorials"). 


T) Wherever possible, it is a good idea to keep all of the resources for your module in the one re- 
source folder that has a similar name to that of your module. 


6. Press "OK" to close the dialog box and create your test area. 


7. With your new area open, look at its editable properties in the "Object Inspector" (bottom-right of 
the toolset), edit the "Name" field and then click on the "Area Layout" field. 


8. Select an area layout by selecting the "..." button and choosing from the list (e.g., "lak202d"). 
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Figure 1: The Dragon Age toolset with a newly created module and area. 


Create a starting point for your module 
The steps you will need to take to tell your module where the player should begin when the module is 


played. 

1. Ensure your toolset looks something like Figure 1. 

2. Right-click in the toolset's environment window (the 3D view of your area) and select "Insert 
Waypoint". 

3. Left-click on an empty space of the area to place your waypoint but keep in mind that you can 


move your waypoint around to wherever you like after it has been created and placed. 


A waypoint is simply a "special point" of your map where things will happen. It might be the 
start location of an area, a point where you spawn an object with a script, etc. 


Left-click on your waypoint and look at its editable properties in the "Object Inspector". 
Enter the name of your waypoint into the "Tag" field of its properties (e.g., "player_start"). 


Open your module's properties ("File => Manage Modules => Properties..."). 


N O um B 


Edit the "Starting Area" field by clicking on it, selecting the "..." button and browsing for your area 
in your module's resource directory (e.g., in "Tutorials" folder, select "scriptingarea"). 


8. Edit the "Starting Waypoint" field by clicking on it and selecting your waypoint from the list (e.g., 
"player. start"). 


9. Press "OK" to close the properties and then "Close" to return to editing your area. 


10. Press "CTRL+S" to save your area. 
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Playtest your module 
The steps you will need to take to export your module's resources (e.g., scripts, areas, etc) in order to play- 
test the latest version of your module. 


1. Select the "ALL" icon on the right of the "Palette Window" (top-left of the toolset). 


Right-click on your module resource directory (e.g., "Tutorials") and select "Export => Export 
without dependent resources". 


3. Check the "Log Window" (bottom-left of the toolset) for whether your resources were exported 
successfully. 


Selecting "Export with dependent resources" is unnecessary and will export the core game re- 
sources it has access to as well and this can take a very long time! 


Run a game of DA:O and select "Other Campaigns" from the game's main menu. 


gs ge 


You should now see your module in the list (e.g., "Tutorials"). 


If your computer can handle it, you can leave DA:O running its main menu in the background to 
save loading the game everytime you want to playtest your module. 


Create a new test script 
The steps you will need to take to attach an empty script to your newly created test area. 


With your test area open, select its properties and edit the "Script" field by clicking the "..." button. 


In the "Resource Open/Save" dialog box, click the "New" button to open the "Create New 
Resource" dialog box. 


Enter the name for your script into the "Resource Name" field (e.g., "area test"). 
Enter the name of your module's resource folder into the "Folder" field (e.g., "\Tutorials"). 


Another way to add resources automatically into your module's resource folder is to right-click 
on the folder in the "Palette Window" and select "New => Script/Area/etc". 


Press "OK" to create your new (and empty) script. 


Because your script is attached to an area, your script will execute (i.e., your script will run) eve- 
ry time a game event related to the area is triggered. 


In the "Palette Window", right-click on your new script and select "Open Resource". 


"^ — I ES 


Copy and paste the following code into the script's text editor. 


1 void main () 

2 { 

3 // This is a comment!!! 

4 } 
The above script does absolutely nothing but keep in mind that commenting any code that is difficult 
to understand becomes very useful when you share it with teammates. 
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Compile your new test script 


The steps you will need to take to compile your script and make sure it doesn't have any errors. 


Compilation is the process of converting human-readable instructions (the code which you write 
T and edit) into computer-readable instructions (a binary file). The compiler will check your code 
for errors and will report whether the compilation succeeded. 


1. The toolset will automatically compile the open script when you save it (i.e. press 


"CTRL+S"). 
T You can also compile the open script manually, without saving it, by pressing "F7". 


2. Check the results of your compilation by reading the topmost entries in the "Log Window" because 
if/when you get errors, this is where they will be reported to you. 


T) To compile all of your scripts (not just the open script), export all of your module's resources as 
described above in section 4, steps 1-3. 


Make your new test script do something 
The steps you will need to take to make your script add an item the player character's inventory every time 
the script is executed and then playtest the results. 


1. Replace line 3 in your script with the following code. 


3 object oPC = GetMainControlled(); 
4 
5 CreatelItemOnObject(R"urn230im armor reward.uti", oPC); 
2. Save your script, re-export your module's resources and then playtest your module again as 
described above in section 4. 


3. While playtesting your module, open your character's inventory by pressing "I" and see the armor 


that your script created inside the player's inventory. 


You've finished this week's tutorial and created a new module, test area and basic script! 
vA But you'll notice that your script created 4 items... Next week we'll look at events and why 


this is the case. You'll also learn how to share your module's resources with teammates and 
transfer them between computers. 


Helpful links 
1. A list of DA:O filetypes and what they mean (link). 
2. A description of scripting changes that have occurred in the last couple of patches (link). 
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Scripting Tutorial 2 - Scripting Events 


This week you will be learning a tonne of stuff but primarily you will be copying and dissecting 2 scripts that 


can handle game events. 


DA:O scripting is all about events. Most of your scripts that you attach to objects will require 
you to handle different events that trigger the script. These events will be triggered auto- 
matically by the game engine, or by actions the player or another object might take (e.g., the 
player or an NPC might move to a new area, in both cases triggering an event). For a list of 


most event types, see the builder wiki (link). 


Duplicate an existing creature template 


The steps you will need to take to duplicate a creature template once you have opened the Dragon Age 
toolset and loaded the test module you created in tutorial 1. 


T You cannot edit existing resources so use the following process to duplicate and then customise 
existing resources of any type (e.g., scripts, item templates, plots, etc). 


1. Find and open the existing "child boy" creature template in the "Palette Window" by selecting the 


® icon and entering "boy" in the filter bar below the icon list (see Figure 1). 


2. Right-click the "child boy" creature template and select "Duplicate" to open the "Duplicate 
Resource" dialog box. 

3. Enter the name of your creature template into the "Resource Name" field (e.g., "boy test"). 

4. Select your module's resource folder in the "Folder" field and select your module in the "Module" 
field. 

5. Press "OK" to close the "Duplicate Resource" dialog box and automatically open your new creature 
template. 
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Instance and customise your new creature template 
The steps you will need to take to place an instance (i.e., sort of like a copy) of your creature into your area 
and then modify the template (i.e., type). 


What you see in the "Palette Window" are types of objects (i.e., templates) and what you 
place into your area are instances of those types. When you modify the type of an object, it 
will modify all of the instances of that type. This is the same as object-oriented programming 
where a class is a type of object and what you add to the code are instances of those classes, 
known as objects that exist at run-time. 


Make sure you test area is open and your creature template is selected in the "Palette Window". 
Left-click on an empty space in the area to create an instance of your creature. 


Make sure the position you choose for your creature is close to the player's starting waypoint. 
The reason for this will become obvious later! 


For fun, open your creature template and edit the "Appearance" field (e.g., select "Pig"). 


BN 


Go back to your area and refresh it (i.e., press "F5" or select "View -» Refresh" in the top menu 
bar). 
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Figure 2: What your area should now look like. 
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Create a new event-handling script 
The steps you will need to take to attach a script to your pig-boy so that it can handle the object's events. 
1. Edit the "Script" field of your creature template by creating a new script in it (e.g., name your script 


"creature test" (if you can't remember how to do this, review the process detailed in tutorial 1, 
section 5, steps 1-6). 


2. Copy and paste the following code into your new script, compile it and read Explanation 1. 

1 void main() 

2t 

3 event ev = GetCurrentEvent(); 

4 int nEventType - GetEventType (ev); 

5 

6 switch (nEventType) 

7 ( 

8 case EVENT TYPE SPAWN: 

9 // give player item when this creature is created 
10 object oPC - GetMainControlled(); 
11 CreateItemOnObject(R"becll0im wedding f.uti", oPC); 
12 } 
13 } 


Snippet 1: A script to handle a "spawn" event by creating an item in the player's inventory. 


1 The definition of the body of this script. 

2 A symbol defining the start point of this script's body. 

3 Creating and assigning a new variable of type "event". The value as- 
Signed here is the event that executes this script. 

4 Creating and assigning a new integer variable. The value assigned here 
is the type of the event variable from line 3. 

6 The definition of a switch statement using the variable from line 4 to 
"control" it. See Wikipedia for more info (link). 

7 A symbol defining the start point of the switch statement. 

8 The first of potentially many case statements inside this switch state- 
ment. Code in the following block (lines 9-11) will only execute/run if 
"nEventType" is equal to "EVENT TYPE SPAWN". 

9 Single-line comment to aid those trying to understand the code. 

10 Creating and assigning a new variable of type "object". The value as- 
signed here is the object representing the character the player is cur- 
rently controlling (very important line of code!!). 

11 Execute an existing function that creates an item (first parameter) in 
the inventory of an object (second parameter). 

12 A symbol defining the end point of the switch statement. 

13 A symbol defining the end point of this script's body. 


Explanation 1: A line-by-line explanation of the code in Snippet 1. 


T If you want more detailed information about Dragon Age scripting and events, see the scripting 
tutorial on the builder wiki (link). 


3. Export your module's resources and playtest your module to see the effects of your code (if you 
can't remember how to do this, review the process detailed in tutorial 1, section 4, steps 1-5. 


Functions were used a lot in Snippet 1 above. Functions are primarily used to either re- 
turn/"get" variables (e.g., lines 3, 4, 10) or to make something happen (e.g., line 11). A 
function takes a list of parameters/values so that it knows more specifically what to get 
or do (e.g., the GetEventType () function in line 4 won't know which event type to 
get unless you supply it with an event instance as the first and only parameter). See Wik- 
ipedia for more info on functions (link). 
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If you're unsure how to use a function, view its definition and extra comments from its author in 
the "Help Window" by right-clicking on it and selecting "Go To Definition". 


Make your new event-handling script do something more exciting 
The steps you will need to take to make your event-handling script repeatedly check the distance between 


the player's character (PC) and the creature executing the script. The script will kill the creature if the player 


strays too far from the creature. 


1. Delete the code you wrote previously in section 3. 


2. Copy and paste the following code in its place. 
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#include "utility h" 


void main() 


{ 


event ev = GetCurrentEvent(); 

int nEventType = GetEventType (ev) ; 

object oPC = GetMainControlled(); 

float fDist = GetDistanceBetween (OBJECT SELF, oPC); 


switch (nEventType) 
{ 
case EVENT_TYPE SPAWN: 
// start the creature's second "timer" 
InitHeartbeat (OBJECT SELF, 2.0); 
break; 


case EVENT TYPE HEARTBEAT2: 
// display how far away player is from creature 
DisplayFloatyMessage (OBJECT SELF, "Dist=" + 


FloatToString(fDist)); 
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21 // test if how far away player is from creature 

22 if (fDist » 8.0) 

23 KillCreature (OBJECT SELF); 

24 break; 

25 

26 case EVENT TYPE DYING: 

27 DisplayFloatyMessage (OBJECT_SELF, "Oh boy..."); 

28 break; 

29 } 

30 } 

Snippet 2: A script to kill the creature it is attached to when the player moves too far away from it. 

3. Compile and playtest the new script to see what it does. 
4. Try and figure out how Snippet 2 does what it does using what you just learnt. Any new 


concepts/keywords you see in Snippet 2 will be explained in future tutorials. 


You've finished this week's tutorial and learnt how to create and customise your own 
creature template, the basics of event handling and some more programming concepts 
like functions and switch-case statements. Next tutorial we'll look at a "nicer" way of 
handling events, some more programming concepts like constants and including files. 
You'll also learn just how the toolset's tag system can make you do some pretty great 
things. 
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Scripting Tutorial 3 - Object Variables and 2DA's 


This week you will be learning how to create and modify 2DA files as well as how to add and use your own 
variables that you attach to your own object (i.e., a new trigger template). You will also be writing a script 
that handles an event properly and dynamically spawns a statute object into your area under certain condi- 


tions. 


Set up your area and resources 

The steps you will need to take to make an area (e.g., your scripting area from previous tutorials) ready for 

your new script. 

1. With an area open in the toolset, create 3 waypoints in an empty patch of floor (see tutorial 1, 
section 3, steps 1-4 for how to create a waypoint). 

T If an area is difficult to view in the toolset (e.g., too dark) then turn off the lighting effects by un- 
selecting "View => Environment => Enable Lighting" in the top menu bar. 


2. Select all 3 waypoints (use shift+click) and edit the "Tag" field (e.g., "spawn point"). 
Editing a field with multiple objects selected, will assign your new value to the field of every se- 
lected object. 
Create a new (and empty) script named "trigger test" or similar. 


3 
4. Create a new trigger template named "create trigger" or similar (if you can't remember how to 
create a new template, review the process detailed in tutorial 2, section 1, steps 1-5). 


5, Change your new trigger template's event script to your new script (e.g., "trigger test"). 


You can only modify a template's "Script" property, not an instance's. This is the case for 

most properties because most of an instance's properties are non-editable. To modify a 

template's property, open it by double-clicking on the template in the "Palette Window", 

edit its properties and save the template. These changes are automatically applied to any 
new or existing instances of that template. 


6. Create an instance of your new trigger template near your group of 3 waypoints and save your 
area. See the builder wiki for more info on triggers and how to create them (link). 
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Figure 1: What your area should now look like. 
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Write your trigger script 
The steps you will need to take to write a script that triggers a visual effect at a waypoint's location. 


1. Open your empty trigger script (e.g., "trigger test") and click the "Templates" icon (E) in the 
scripting assist window on the right of the code editor. 


T) The script assist also has a list of accessible functions, variables and constants to use. 


2. In the script template list, double-click "Custom Trigger Events.txt" to insert a base for your new 
trigger script 


Notice how the template script is set up to handle an event properly by executing the core 
trigger script if you don't reassign the "nEventHandled" variable. See the builder wiki for more 
information about overriding an event script (link). 


3. Copy and paste the following code in place of your new script's "EVENT_TYPE_ENTER" case, 
compile it and then playtest your module. 


12 case EVENT_TYPE_ENTER: 
{ 


object oCreature = GetEventCreator (ev); 


// new variables 
object oWp = GetObjectByTag("spawn point"); // one of your new waypoints 


location 1Wp = GetLocation(oWp); // location of that waypoint 
effect eFog - EffectVisualEffect(4031); 


// create the effect 
Engine ApplyEffectAtLocation(EFFECT DURATION TYPE TEMPORARY, eFog, l1Wp); 


// tell the core script not to execute after this 
nEventHandled - TRUE; 


break; 


Snippet 1: A code block to create a visual effect at a waypoint's location. 


N 


The beginning of the block that executes if the switch variable (i.e., 
in this case "nEventType" from line 27) equals this case (i.e, 
"EVENT TYPE ENTER"). 
43 A symbol defining the start point of this particular case. 
Creating and assigning a new variable of type "object". The value as- 
signed here is the first object it finds that has the tag 
"spawn point". 
3 Creating and assigning a new variable of type "location". The value as- 
signed here is the location of the waypoint from line 47. 
9 Creating and assigning a new variable of type "effect". The mystery 
value assigned here is the ID of a fog-like visual effect. 
32 Use the variables created earlier to spawn a visual effect. 
Set the flag responsible for calling the trigger's core script in line 
TL: 
57 A statement that causes execution to leave the switch statement (used 
in multi-case switch statements). 
58 A symbol defining the end point of this particular case. 


Explanation 1: A line-by-line explanation of the code in Snippet 1. 
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Create a new variable 2DA file 
The steps you will need to take to add a variable to your own trigger variable 2DA file. 


2DA files are nothing more than a simple spreadsheet (.XLS file) with cells of data (e.g., special 
numbers and strings) organised into titled columns and grouped together in rows. See the build- 
er wiki for more info on 2DA files and how they are used (link). 


ject template (e.g., a trigger template). 


Object variables (also known as "local variables") are variables that are attached to each instance 
of a particular object template. Most types of objects have a set of pre-defined variables defined 
in a 2DA file (e.g., triggers, areas, NPC's, creatures, etc). 


Every instance of an object template is attached to an instance of the set of object variables (e.g., 
all trigger instances of the same type/template do not share variables, each trigger instance has 


T In this section, we use 2DA files that define a list of object variables that are attached to an ob- 


a copy of the variables defined in its template's 2DA). 


1. Find where all the object variable 2DA file lives by finding the following folder on your hard-drive: 
"«DA:O Install Directory» \ tools V Source V 2DA V toolset". 


A If you purcahased DA:O on Steam, your DA:O install directory will be: "«Steam Install Directory> 
\ steamapps \ common \ dragon age origins". 


Copy "var trigger.xls" to an empty folder (e.g., on the desktop) and open it. 
Copy row 17 into row 18 and replace "TRIGGER ROOM TEXT" with "TIMES TRIGGERED". 


Bow m 


Change the name of the worksheet (e.g., "var create trigger"). 


Spreadsheet files are made up of multiple worksheets (also known as "workbooks"). However, in 
this case the 2DA file only contains one worksheet. 


5, Close the spreadsheet file. 


Compile a 2DA file 


The steps you will need to take to process your new variable 2DA file into a .GDA file using the "ExcelPro- 
cessor" tool. 


In order for the game to read the data in 2DA files, they need to be processed into a .GDA file. 
The .GDA file that results from a 2DA is named after the worksheet in the 2DA file (e.g., 

"var create trigger") and not the filename (e.g., "var trigger"). See the builder wiki for more 
detailed info on compiling 2DA files (link). 


1. Find the "ExcelProcessor.exe" file found in the following folder on your hard-drive: "«DA:O Install 
Directory» \ tools V ResourceBuild X Processors". 


2. Copy the ExcelProcessor program into the same folder as your new 2DA file. 


3. In Windows Explorer, drag your 2DA file onto the ExcelProcessor program to automatically create 
your .GDA file somewhere inside your current system profile (e.g., on Windows XP, it should create 
your .GDA file inside: "C:\Documents and Settings\<Profile Name>"). 


4. Copy your new .GDA file to your module's folder on your hard-drive: "«My Documents» X BioWare 
X Dragon Age \ Addins V «Module Name» \ module V override". 


5. Open and close the toolset so you can access your new .GDA file from within the toolset. 
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Use a .GDA file 


The steps you will need to take to make use of your new variable inside your .GDA file 


1. 


Open your trigger template and edit the "Variable 2DA" property by adding the name of your new 
.GDA file (e.g., "var create trigger"). 


Open your trigger script (e.g., "trigger test") and replace the code you added in section 2 with the 
following code: 


case EVENT TYPE ENTER: 


{ 


object oCreature = GetEventCreator (ev) ; 


// get and print the value of our new 2DA variable 
int timesTriggered = GetLocalInt (OBJECT SELF, "TIMES TRIGGERED") ; 
DisplayFloatyMessage(oPC, "TIMES TRIGGERED-" +IntToString (timesTriggered) ) ; 


// exit switch-case statement if already been triggered at least 3 times 
if (timesTriggered >= 3) 
break; 


// new variables 

object oWp = GetObjectByTag("spawn point", timesTriggered) ; 
location 1Wp = GetLocation(oWp); 

effect eFog = EffectVisualEffect (4031) ; 


// create the effect 
Engine ApplyEffectAtLocation (EFFECT DURATION TYPE TEMPORARY, eFog, l1Wp); 


// just for fun, spawn a statue 
CreateObject (OBJECT TYPE PLACEABLE, R"genip totem ds.utp", lWp); 


// increment our new 2DA variable 
SetLocalInt(OBJECT SELF, "TIMES TRIGGERED", timesTriggered + 1); 


// tell the core script not to execute after this 
nEventHandled - TRUE; 


break; 
Snippet 2: A code block that gets/sets an object variable. All new code is highlighted. 


Add the following line after the "HandleEvent" function call: 


DisplayFloatyMessage(oPC, "handled by core script"); 


Compile and playtest the new script to see what it does. 


To further demonstrate the usefulness of object variables, create a second instance of your trigger 
template (e.g, "create trigger") somewhere else in your area. 


Select your new trigger instance and click on the "..." next to its "Variables" property to open the 
"Variables" dialog. 


Change the "Value" of your new "TIMES TRIGGERED" variable to "2". This will change the default 
value that this variable is initialised to, each instance can have different initial values! 


Playtest your module again to see what difference this change makes. 
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Questions? 
1. So where did that magical visual effect ID ("4031") from the earlier sections come from? 


Normally you would be able to use a constant to reference these type of numbers but as 
far as I know, you can't see the list of visual effects this way. Perhaps because there's so 
many of them? To see a list of which ID equals which visual effect, go to the following di- 
rectory on your hard-drive: "«DA:O Install Directory» \ tools V Source V 2DA" and open 
"VFX base.xls". There's also heaps of other data in this folder that you might find useful. 


2. If we use the toolset's "Builder to Bulder" tool to transfer our module between computers will our 
.GDA file or anything else we place in our module's override folder be automatically copied as well? 


No, you need to manually copy all files you place in the override folder in addition to creating a 
builder package of your module's resources. If you find a better soluion, please share it! 


3. How can | find out which header file | have to "include" (same as "import" in Java) in order to get 
access to the functions that | need? 


As far as | know, there's no quick way to know which header files contain which functions. 
You can however, view all of the available header files by clicking the script icon ( B) in the 
palette window, unticking "hide folders" and searching for "_h" (see Figure 2). This way 
you can see the names of each header file and double-click on one to see what functions 
are inside. Because they also contain implementation, studying them should help you 


Palette Window - Script 


ao | - — —] 


E Only show resources checked out to me 
Hide folders 
(8 2da constants h n 
(d 2da data h 
8 ability n 
(d ability summon h 
(d achievement core h 
8 ai ballista h 
(d ai behaviors h 
(d ai conditions h 
(d ai constants h 
@ ai main n 2 
(d ai threat h 
aoe effects h 
dl annroval h 


El 


Figure 2: How to search for all available header files 


7 learn how to code. 
You've finished this week's tutorial and learnt the basics of 2DA's and object variables. Next week 
we'll learn how to solve a reasonably complex problem involving an NPC and a conversation. 
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Scripting Tutorial 4 - Problem Solving 


This week you will be learning how to solve a problem with very little help! 


The challenge 


Using skills from previous tutorials, implement the following: 


1. 
2. 


Each time you talk to a custom NPC, it walks to a random waypoint in the current area. 


Now make it so that the NPC will never walk to the same waypoint as the one they are currently 
standing at (i.e., avoid the NPC not walking at all). 


Now make it so that the NPC will no longer walk to a new waypoint after a particular number of 
times (e.g., 3) and will instead tell you that it is too tired to walk any further. 


To possibly make things harder, make it so you only have to change the set of possible waypoints 
the NPC will walk to by adding/removing the waypoints and changing only one number in your 
scripts. Although this might not make you change your implementation, it's an example of 
requiring that your code is more flexible and useful. 


To make things even harder, make it so that once the NPC has walked to a particular number of 
waypoints, it will not tell you it is too tired but will instead list all the waypoints that it walked to. 


A solution will be published in the next tutorial! 
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Scripting Tutorial 5 - Problem Solving Solution and 
M2DA's 


This week you will be learning one method for solving the problem in tutorial 4 as well as using M2DA's to 


Solution to the challenge 
The srcipt and steps that solve most of the "creature talking/walking" problem from tutorial 4. 


1. Scripts for parts 1, 2, 4 and 5: 


#include "move random wp h" 


void main() 


{ 
object oPC = GetPartyLeader () ; 
int nWp = MoveCreature("fred", "walk point", 5); 


DisplayFloatyMessage(oPC, "walking to waypoint #" + IntTo- 
String (nWp) ) ; 
} 


Snippet 1: Conversation action script to be placed on dialogue line that triggers the NPC to move. 


#include "move random wp h" 


int StartingConditional () 
{ 


return MovedEnough ("fred", 3); 


} 
Snippet 2: Conversation condition script to be placed on start of a dialogue chain "below" snippet 1. 


#include "move random wp h" 


void main() 
A 
string sNpcTag = "fred"; 
object oNpc = GetObjectByTag (sNpcTag); 


DisplayFloatyMessage(oNpc, "I walked to " + GetWpList(sNpcTag) ) ; 
) 


Snippet 3: Conversation action script to be placed at end of same dialogue chain as snippet 2. 


HSSTEPTPEEFILITEIPEHTIREHUFTEHHTETEHLELTEEEHPEEHHE 
//:: Helper functions for telling a creature to move to random waypoints. 
IEA NAAA RIIIE IA AAA AMARA IRA RARA DARA RES 
| //:: Created By: Stephen Karpinskyj 
//:: Created On: April 9th, 2011 
VISALIA LAAIE 


const string VAR_WALK_COUNT = "CREATURE_COUNTER_1"; 
const string VAR PREV WP = "CREATURE COUNTER 2"; 
const string VAR WAYPOINT LIST = "SURR PLOT NAME"; 


int MoveCreature(string sCreatureTag, string sWpSetTag, int nWpSetSize) 
( 

object oCreature = GetObjectByTag (sCreatureTag); 

int nPrevWp = GetLocalInt(oCreature, VAR PREV WP); 

int nWalkCount - GetLocalInt(oCreature, VAR WALK COUNT); 

string sWpList = GetLocalString(oCreature, VAR WAYPOINT LIST); 
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int nWp; 
20 
21 while (nWp -- nPrevWp) 
22 nWp = Random(nWpSetSize); 
23 
24 object oWp - GetObjectByTag(sWpSetTag, nWp); 
25 command cMove - CommandMoveToObject (oWp) ; 
26 
27 if (nWalkCount -- 0) 
28 sWpList - ""; 
29 
30 AddCommand (oCreature, cMove); 
31 
32 SetLocalInt(oCreature, VAR WALK COUNT, nWalkCount + 1); 
33 SetLocalInt(oCreature, VAR PREV WP, nWp); 
34 
35 sWpList += " " + GetTag(oWp) + IntToString (nWp) ; 
36 SetLocalString(oCreature, VAR WAYPOINT LIST, sWpList); 
37 
38 return nWp; 
39 } 
40 
41 int MovedEnough (string sCreatureTag, int nMax) 
42 ( 
43 object oCreature = GetObjectByTag (sCreatureTag); 
44 int nWalkCount = GetLocalInt(oCreature, VAR WALK COUNT); 
45 
46 if (nWalkCount -- nMax) 
47 { 
48 return TRUE; 
49 } 
50 else 
51 { 
52 return FALSE; 
53 } 
54 } 
55 
56 string GetWpList(string sCreatureTag) 
57 { 
58 object oCreature = GetObjectByTag (sCreatureTag) ; 
59 
60 return GetLocalString(oCreature, VAR WAYPOINT LIST); 
61 ) 
Snippet 4: Include script containing constants and implementation of functions used in above scripts. 
2. Other than writing the above scripts and adding them to a conversation attached to your 


NPC in your area, you should add a set of waypoints (all with tag "create_point") to your area. 


The solution above is reuseable because we only need to write the important 
code once and pass it different parameters (e.g., creature and waypoint tags). 
While this example might not have called for a reusable solution, (i.e., the code 


might only ever be used once) it at least demonstratess how you might write re- 
usable code using parameters and functions in an external file. 


The solution to part 5 is not very "nice" because the toolset doesn't allow talk table 
strings (that includes exported dialogue conversation lines) to be modified at run- 
time (i.e., a script cannot modify/set a conversation line, only read/get). 
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Adding a spell 


Now that you've got a lot of the basic DA:O modding knowledge, you should be able to start following oth- 
er tutorials that require basic knowledge. For example, try following this "new spell tutorial" (link). 


The tutorial mentions that similar steps are required to add or modify talents and abilities as 


Although the spell tutorial doesn't mention "M2DA's", it actually asks you to add to one by cre- 
ating a new 2DA ("ABI Base fh"). Because your new 2DA has a special prefix ("ABI "), the game 


actually combines your new "ABI Base fh" file with all other 2DA files that have the "ABI " 
prefix. 


M2DA's are useful because you can add to existing 2DA's (e.g., a list of "placeable types") 
without copying potentially hundreds of rows from the original 2DA (e.g., you can create a new 


2DA called "placeable types something" with your new placeables and the game will merge 
this with other "placeable types *" 2DA's to form a "placeable types" M2DA). 


For a list of M2DA's, see the "M2DA base" worksheet in the "2DA base" 2DA file. 
Interestingly, you can create new M2DA's using this method because "M2DA base" is itself an 


M2DA (e.g., create a new 2DA called "M2DA something" that has a list of your new M2DA pre- 
fixes). See the builder wiki for more info (link). 
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ART & DESIGN 


Tutorial 1 - Introduction 


The Toolset 
When you first open the toolset it looks pretty empty, the first thing you will want to do is make sure you 
have the Palette and Object inspector windows open. 


= File Edit | View | Tools Window Help 


Resource History 
| OtherWindows  » 1 Bookmarks 
Refresh F5 Console Window 
Refresh (No Art) Shift«F5 Conversation Line Preview 
Refresh Override  Ctrl+F5 Help Window 


Palette Window - Area 


(^20omu»x 
a SERCE” 975 


w 


-E Global 


"Object Inspector 
Select an object 


(1) Log Window | {i$ Bookmarks | P] Console | 


Mouse Pos: ||Toolset Memory Usage: 275 MB ||Database: ABWDATOOLSET:bw_drac[S] 


It is also a good idea to have the Log window open, so you can see what is happening this is particularly 
useful when you are building, rendering in and exporting levels. 


Note: If you have mods or expansions installed make sure you do not use the resources from them in your 
assignment. We mark on computers that have the same set up as the ones at uni which do not have the 


various expansions or extra mods installed, therefore they will not have the resources and they will not ap- 


pear in your mod when we play it, often this will cause it to crash. 


The main menu contains all the standard file, edit, tool, window and help properties and are consistent 
across all resource editing windows, | recommend you become familiar with them. 
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The top menu contains editing type specific controls, it contains most of your basic functions like save etc 
as well as all functions related to resource manipulation, rendering, building and much more. These menu 
bars are Resource specific so they will change with the type of resource you are editing. 


The palette window is where you find all the game resources such as placeables, items, character models, 


interior terrain tiles etc. Basically every single resource in the DA:O game and any mods or expansions you 
have installed. 


Each resource is organised into a category you have: 
ES Areas 
AL i 
Area List 


2 Characters 


- Palette Window - Area nx 


! . 
*~ Conversations 


DLEE EREE 
E SG ™& 


a Creatures 


»- Cut Scenes 


E 
Items - | Only show resources checked out to me 
E Maps — Hide folders 


3 = Global 
Merchants 8 avalon00lare 


m Placeables à 
T Resource File 


B scripts are - area 


ld Client Scripts 


= Stages 


9 Triggers 
J Sounds 
ği Models 


Me Display All 


You also have a filter option where you can search for resources, this is mainly useful when you have the 
Hide folders option checked which is accessed by clicking on the triangle next to the filter box. 


As you will notice the resources themselves, in this views do not have very descriptive icons, to see what 
each of the models looks like you can look up the Lists with screen shots on the builder Wiki: 


e Models 


http://social.bioware.com/wiki/datoolset/index.php/Model list 
* Vegetation 


http://social.bioware.com/wiki/datoolset/index.php/Vegetation_list 
e Terrain Textures 


http://social.bioware.com/wiki/datoolset/index.php/Terrain list 
e Vista Objects 


http://social.bioware.com/wiki/datoolset/index.php/Vista_object 
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The object inspector is where you will find all the resource properties, but we will look at that in more de- 


tail later. 


First thing we are going to do is create a module, Stephen will go into this in 
more detail next but for the moment we will simply do a basic set up. Go to 
File » Manage Modules. 


This will open up the modules manager, first thing we are going to do is click 
New... This will open a new module properties window. You have a huge 
number of options here and most of them you will want to tweak later on 
when you have some basic bits set up, but for the time being we will just set 
up the two most important things, the Name and UID fields. Name is the vis- 
ible name of the Module In this case put in Game Studio Tutorials. The UID is 
the Mod's unique identifier string in this case put GS1TUTS. Then Click OK 
You will now have a new module called Game Studio Tutorials Select it and 
click Open. 


BE 


E General 


Client Script 
Include In Resource Build 


Script 

Starting Area 
Starting Waypoint 
StringID Begin 
StringID End 


(None) 
False 


module_core 
(None) 


2125460880 
2125470880 


StringID Last Used 2125460879 


Type Addin 
wo 


El Info 
Content Module 
Description 
DescriptionStringID -1 
DisplayName 


(None) 


File | Edit View 
New 
[1 Open File 


Tools Winc 


Ctrl+0 


Ctrl+S 


Restore Environment 
Recent Files 
Exit 


You now have a new module, however there is nothing in it. If you want to find the mod files on the com- 


puter you will find the them in the BioWare Folder > Addins > GS1TUT (Or whatever UID you choose to use 


for your mod). 


If you want to see a breakdown of the module properties see: 
http://social.bioware.com/wiki/datoolset/index.php/Module#Properties 
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Levels 101 


In the Original NWN2 toolset 'Areas' and 'Levels' were synonymous however with the new DA:O resource 
structure system, Levels and areas are two different resources. Levels are the static parts of an area e.g. 
the terrain itself, buildings, trees, terrain textures, placeables and junk that the player doesn't interact with 
aka the decoration. Levels can be interior or exterior and contain quite an array of complex elements. Once 
a level is finalised it is imported to an area so that the designers can build upon the static terrain and create 
the dynamic elements. It is important to remember the spaces needed for the dynamic elements when you 
are building a level, you may choose to use place holder objects while you build a level just so you make 
sure to leave enough space. When it is finished the level is exported, this exported file includes, lightmaps, 
water reflections, placeables, trees and grass, walk maps, sounds etc . These are then imported into an area 
masking the framework of it. 


To create a new level you need to go to File > New > Level. Once [File | Edit View Tools Window Help 
this is done select Room Level » Next » Finished. Now you have | New >| Animation Worksheet 
F ET A A a | Open File Ctrl-O A 
an empty room with no floor, walls or ceiling. First things first ‘ T pa eN 
rea Li 
you will need to learn to navigate in this space, There are two Q Character 
styles of camera controls Fly cam and 3DSMax, you can change [C] Client Script 
Conversation 
the control system by clicking on the camera control buttons pum 
mg i d Cutscene 
- . The Alt is the 3DSMax system and the one I prefer: S 
GFF (Eclipse Format) 
e Press and hold middle mouse button = pan ion Md d (NWN Format) 
. B 3 Kem 
e Press and hold middle mouse button + Alt Key = Rotate Restore Environment aT 
Ri Fil 
* Mouse wheel = zoom iere ar Map 
Exit : 
Material 
* Ctrl + mouse wheel = Speed Zoom 29 
$$ Merchant 
e  Z=centre and zoom in on the centre of the level Morph 
fw Placeable 
But you can also to the fly cam (WASD) B Plot 
Resource Image File 
B Script 
e Az=PanLeft B us 
? D = Pan right @ Trigger 
e W -Zoom in -og Window i YX 


e S=Zoom Out 
e Hold Centre Mouse Button = Rotate 


scroll wheel = Zoom 
+ Ctrl + hold centre mouse button = rotate on light on sight 
e Z=centre and zoom in on the centre of the level 


The next thing you will notice is that a new window had appeared down the left side | call this the resource 
tree as it displays a tree of all the elements or resources within the 
resource you are editing. 


Once you have this started we will start to place a floor. One thing [ox] 
you will want to do before building interiors at least for the floor and — Cancel 
walls is turn on Grid Snapping. Click on the little magnate on the top v| Snap Z Size Independent 


3.000 


(V| Enable Snap Rotation 


45.000 


the tool bar ^ . This will bring up the snap tool bar Enable Snap to 
Grid at 2.000 and Enable Snap Rotation at 45.000, This will just 
make the basic room setting up easier. 


4 | Enable Snap to Surface 


There are a couple of things you will need to do before you start placing room tiles, first make sure the 


'View Models Fully Lit' button (js on this means that it will light everything equally in the level and have 
no light mapping, and since we have no lights in the level currently this is what we need to see what we are 
doing. 


Next click on the New Area Label in the Resource Tree, This needs to be selected to place your floor or any 
models in the Level. You will also need to set up a few properties for the new area before we begin. Once 
you have selected 'New Area' look at the Object Inspector, there are a whole bunch of properties here 
which you can change and tweak to fit your level, the two that you MUST CHANGE or you won't be able to 
build you level is the Layout Name and Name. The Layout Name is the name of exported layout file it has 
to be less than 8 characters with no spaces or symbols. | will set this one to Layout Name: GSlvl1 and set 
the Name: gs1 interior 01. 


Now right click on the 'New Area' and select Insert > New Room. This will Create a 'New Room' child node 
under the parent 'New Area'. You should now begin to see that the DA:O System is very hierarchical. You 
have parent objects or nodes and underneath them you have child nodes, one parent node can have many 
children but a child may only have one parent. 


Z4 Room World 


OA New Ares 


% Cut Ctrl+X New Wind Object 


=3 Copy Ctrl+C 
DM Paste Ctrl+V 
X Delete Del 


Select All Ctrl- A 


Select Models Matching Name Ctrl+Shift+ A 


Once you have got all this set up it is Move 
Select 


important to mention the Move, Rotate, 
Select and view axes tools, which you 


will definitely need in the next step. Snap to grid m | 


These can be found to the right in the 


top menu, they allow you to manipulate 
the objects or tiles within the level. 


Next comes the fun part, select a floor! Rotate 

To do this click on the models button in 

the Palette window (The blue box) and type floor into the filter, check hide folders if you want to see the 
individual resources. Once you have decided on the floor you want, | will use fca_floor01_0. Select the New 
Room in the Resource Tree and place the tile of floor on the grid by left clicking. You can now Copy and 
paste this tile using Ctrl + C and Ctrl + V to duplicate the tiles. Use Ctrl + left click to select multiple tiles if 
you want to duplicate multiple tiles. Copy and paste the original tile, use the Move tool and select the axis 
you wish to move the tile along and arrange them next to one another. continue this process until the floor 
is as big as the room you wish to create. For the moment keep it square or rectangular. 
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View Axes 


Next comes the Walls. A good trick to remember is the first three 
letters of the file name of the element you used is the folder 
name and within the folder they often have matching floor, wall 
and ceiling tiles. | am going to remove the filter and get back the 
folders then expand the 'fca' folder > wall01 > fca wallO1 O. 
Now | have a wall tile | can begin to build with, Place the wall at 
the edge of the floor tile and place it. Copy and paste it till you 
have a whole wall, when you get to a corner instead of simply 
moving the tile rotate it as well (this is where the snap to rotate 
helps) place it at the corner and continue until to have a whole 
room, you can now add the ceiling the same way. If you have 
had experience with Never Winter Nights you will know there 
was no ceiling, however in DA:O you need one as the players 


fixed camera angle is low enough that they can actually see the 
ceiling. 


If you are looking at adding a door way between a corridor or 
rooms you will need to find the relevant tile, not only that but 
you will make sure you put a matching one on the back as all 
these walls are one sided. You will lose marks in your assign- 
ment if we find one sided walls in your interior. It is also a good 
idea to add a New Room to the resource Tree and place the 


new room's tiles within that 'New Room', it will give you allot 


more flexibility later and you can also name the rooms using the 
Name property which helps with ease or reference later 


| will place the tile form fca > door01 »fca door01 O0 in the space of one of my walls, you may need to jug- 
gle pieces around a bit and turn your snap to 1 as the door walls can be differently sized. Now you will 
need to copy and paste that same doorway and rotate it 180 degrees. Put it on the other side of the door 
way so it matches up and now you can build another small room. You will add the doors in the Area editor, 
as they are considered dynamic elements. 


The next thing we want to do is add two lights, so right click on the New Room label in the Resource Tree 
and click Insert » New Light. 


©] GS1100IlvI InteriorO1lvi | 


=) @ Room World 
Cap New Area 


ie 
Spawn Model 
{% Cut Ctr+x | New Light 


Gi 

Si 

ği 1-3 Copy Ctrl+C New Light Probe 

ği GA Paste Ctrl+V New Group 

: | X Delete Del New Wind Object 

"E Select All Ctrl- A New Test Creature Object 
wf Select Models Matching Name Ctrl+Shift+A 


Once you have done this place select it, then go to the Object inspector. This is where you have all the pos- 
sible light settings, including colour type intensity etc. For the moment just set Light Type: Point - Stat- 
ic(Ic), you will also want to change the Name to PointStaticO1. If you want to can fiddle with the colour and 
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intensity, but at the moment I will leave it how it is. Select it and move it to where you want, you may want 

to turn off the grid snapping when you want to position these. Realistically you will need one point static 

light per 'room' so you don't end up with very dark rooms. | am just going to add a light to the other room 

Set it to Point Static and callitPointStaticO2. Now! [ETA ca E = : 
will add another light to the main give it a Name of i 
Ambient01 and set it to Light Type: Ambient 
Baked(L) You will want to set the colour on this one 


Standard] Custom | 
Colors: 


0.50,0.50,0.50 v 


to something dark, this 


Light ID 36 3 
Light Type Ambient - Baked (L)| |) 
Name light at 
Selection Lock Normal i 
Visible True 

Location 

Position X 0.6906551 

Position Y 5.312 

IE. Position Z 2.721049 

Rotation X (degrees) 0 


9E 
becomes the colour/tint of sa 
E) GS110Q Render Lightmaps 


the shadows. To do This go 
to Color, select it and click 
on the down arrow. Here you can select your colour. 


Current 


Then click OK. Once that is done click on the render 


light maps button, watch the log it will tell you when 
Rotation Y (degrees) 0 


Rotation Z (degrees) 0 


— a maa 


Color 


it was successful. | will talk more about these 


nest week but for the, moment we will just 
render it. To see the light map turn off the global 
lighting and turn on light map (LM). 


Once you have built the two rooms you will need to connect the rooms using the "Room Properties 


B 


ject Inspector. Select the room in the resource tree and click on the "Room properties button". Here you 


tool". make sure they are uniquely named by selecting the room then changing its name in the Ob- 


will see a window like this: 


These rooms are VISIBLE from the currently selected room: These rooms are directly CONNECTED to the current room: 


Visible Rooms Add Connected Rooms 


e | 


Generate Visibility Graph 


Highlight visible rooms 
Automatically add visibility links from target to source rooms 


These rooms are LIT by lights from the currently selected room: 


Lit Rooms 


Once you are here you can control how the room rendering using the VISIBLE ROOMS section, you can set- 
up which room is connected to which using the CONNECTED ROOMS section and you can also set up the 
room lighting, what lights from what rooms effect other rooms. 


Now you have a level, it is not quite ready for importing into an area but it is a good start. next week we 


will look at External Levels and more on lights as well as area props. 


Now save your level remembering the DA:O Naming Conventions, e.g. GS1100lvl InteriorO1.lvl. 
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NOTE: the .lvl file itself can be saved anywhere it is the exported files (which we will get to next week) that 
are important you can take home the .lvl file without editing any databases as it is considered an art re- 
source, however when you start getting to exported levels and areas you will have to start exporting and 


importing the game objects properly. 


This is a start, but not a playable area or level yet. Today once you have formed your groups | want you to 
start exploring the interior tiles, look through the toolset at all the floor, walls and ceilings and start making 
notes about what tiles suit what themes, tile sizes etc. You will find this information very useful when you 


come to building your Levels for your mod. 
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Tutorial 2 - Exteriors, Water, Vegetation and Models 


Exteriors 

So Last week we created an interior today we will be looking at exteriors. To do that we will first make sure 
our module is selected, to check go to File » Manage modules and make sure that the module you wish to 
be working on is open. Next go to File > New > Level. This will bring up a new window, keep Terrain 
(Landscape) Level selected, then click next you will then see this window: 


Desired width (east/west) Desired height (north/south) 
64 64 


Base Mesh Resolution (m) Chunk Size (m) 
2 32 


|] Create a default water plane 


e Desired width (east/west) & Desired height (north/south) - is the terrain dimensions in meters, 64 
by 64 is about the minimum that you'd want to use and 256 by 256 is probably the largest we'd 
recommend for performance sake. 

e Base mesh resolution - the size of the individual triangles that make up the terrain mesh, we'll talk 
more on this later when we get to the tessellation tool. 

e Chunk size - chunks are the basic simulation unit used by the engine, the default 32m is a good size 
it is best to leave it as is. 

e Create a default water plane - if you know you really want to add a water plane then you can select 
it here, but generally | wouldn't bother as it is very easy to add later. 


For the moment leave these how they are and click on the "Advanced..." button. This changes the display 
to the advanced options. 
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Enter the desired values for resolution, size, and tessellation. 


Mesh Cells Per Chunk 16 Number of chunks X 
Base Mesh Resolution 2 Number of chunks Y 
Blend Texel Resolution: — 50.00 Blend Mask Size: 


Chunk Size Area Size 
Length: 
Width: 


Tessellation Test. Use the controls below to see what resolution you get at different tessellation levels. The value 
you input here has no effect on the level that you are about to create. 


Tessellation Level: 3 = Max. Resolution: 0.25 


ERN TEN 


Here you can do some fine tweaking. Really the only thing you may want to tweak here is the Tessellation 
level, but for the moment we will just leave it all as it and click back to the basic view using the "Basic..." 
button. Now click "Next>". This is just a summary of your terrain if you decide you want it bigger or want to 
tweak something, you can just click "« Back" and edit your terrain. We'll just click "Next »" and get to work. 


There are a few import5ant menus that | want to go through now, so that when we get to editing you'll 
know what's what. 


View Controls 


LI ü gg rs E t. sma om telo». 


This menu controls what control system you have mapped as well as what you can see in your level and 
how you see it. 


mu These two buttons control the style of camera controls you wish to use (as discussed last week) 


D These two buttons control the lighting style you will see, the LM (Light Mapping) one is currently 
greyed out because we haven't generated a light map. The second button is universal or flat lighting, it just 
means that everything is equally lit, this is good for the initial building stage. If you can only see black when 
you first make a level make sure this is set on so that you can see what you are doing. 


Igi e [4] i Small (20m) v 


Atmosphere effects (such as fog), Terrain chunk boundaries, Highlighting of accessible and inaccessible ter- 


The buttons controls what you see in your view e.g. Buffer effects, 


rain, Tree draw distance settings and toolset render distance. The toolset render distance is by default set 
very small (20m) you will probably want to increase it, the amount of vegetation you have and the power of 
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your computer will control what render distance you want but if you have a good enough machine you 
should be ok to put it to the Very Far setting (300m). 


Kes 


These buttons control the view preferences for objects, e.g. tactical rim lighting, fade cut 
away and object collision boundaries. At this stage, while you build your level, will just be using the last 
two. 


This button enables or disables the refreshing of the render window. I haven't used this yet, but you 


may find it useful at some stage. 


Area Controls 

-—---BEHB. 
At the moment these are mostly greyed out, because your level does not yet have its exportable settings 
set up. | will show you that later today however, it is a good idea to be familiar with them. The drop down 
menu is the list of areas that the level can be exported to, generally you will only have one, however if you 
wanted a dusk or night version of the same level you can create a second and adjust the lighting and envi- 
ronmental effects( fog etc.) to give you all the necessary rendered light mapping. The second is your area 
properties, you will use this allot later when we get to exporting and setting up some of our area settings. 
The "+" button is to create a new exportable area, which does just what it says, its partner the "-" button 
does the opposite it deletes an exportable area. The fifth grid looking button is the "Chunk management 
tool" it allows you to tweak the setting of each chunk. The final is the Room Properties tool (see last week's 
tutorial). 


Terrain and Water Editing Tools 
NEBBHNMEZEZ.-90:2234ac-. 
This is the main menu you will use when constructing your terrain level: 


This is the model placement button, it allows you to place models in the level. 


This is the Scatter Object tool, it allows you to place vegetation e.g. trees and grass in your level. 


sellate 


These are the terrain editing tools: 1. Deform (Raise & lower), 2.Plateau, 3. Smooth, 4. Tes- 


Jmm 
Paint, 2. Texture Smooth (Like a blend using transparency), 3. Relax map (if a texture is stretched it will un- 
stretch it). 


These are the terrain texturing tools, that allow you to paint textures on the terrain: 1. Texture 


For a really good break down of the terrain tools and texture tools inc. their properties see the wiki : 
http://social.bioware.com/wiki/datoolset/index.php/Terrain mesh 


m 
Y: de These are the water collision tools, most of the properties you will set for water will be in 
the water's properties or the other options, Surface Colour & Wave Settings, that you will find in the object 
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inspector. However if you want to edit a water planes collision style etc you should look here. 

1. Automatically Tessellate the water to allow for increased vertices at the shoreline, 2. Show Water colli- 
sion Mesh, 3. Generate water collision geometry for the selected water node, 3. Generate water collision 
geometry for all water nodes. 


a: wá These are the terrain collision tools. 1. Show Terrain Collision, 2. Build Terrain Collision, 3. 


Snap Terrain Collision. 


Light Map Rendering 


These are the light map rendering tools. Once your level is set up as an area and has some Lighting set up 
you can export the light maps. The options are 1. Render Light maps (Cached Scene), 2. Render Light maps 
for selected room or chunk (Cached Scene), 3. Render Light maps, 4. Render Light maps for selected room 
or chunk, 5. Render Light Probes. | mainly use the last 3, particularly 3 & 5. We will deal with light probes 
later but what they do is generate a water's reflection relative to the level, e.g. trees/buildings overhanging 
the water get reflected. 


Start Point and Walk Map Rendering 
rok a 


These tools allow you to set up the level walk maps. 1. Set up Start Point, 
2. Toggle display of path finding nodes, 3. Generate path finding for active 
area, 4. Generate path finding but skip the footstep-sound generation 
step. You always need to place a start point to generate a walk map, it 
sets the area within which the player will move. e.g. If you had an level 


Walkable area 


which was surrounded my an impassable mountain range, you wouldn't 
want the player to walk on the other side of the range. So you set the 
start place inside the range and the path finding generates, in relation to 
that point, where the player can and can't go. You can then tweak the 
automatically generated path finding with the Collision tools discussed 


earlier. 


Level Exporting 


La da Ya de de 


This is where the bugs pop up! These are the tools you use to export your level ready for use in an area. 1. 
Post Selection to Local, 2.Post trees to Local, 3. Post only object Locations to Local, 4. Post to Local, 5. Do all 
local posts. Generally it is safest to do 5, which can take a while but exports everything in case you forgot 
do something, or a change you made inadvertently changed something else, it renders the light maps, 
walk-meshes, exports the trees, and object placements as well as the terrain mesh. 
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Editing Terrain 


Now we have our head around what tools we have available we can start editing. 


Select the Deform tool. This deforms the terrain left click to raises the terrain and right click to lower. 
When you have the tool selected look at the Object Inspector. Here you have a range of brush options: 


These options allow you to tweak the brush size, pressure, noise, 


| Object Inspector ax 

E Bj deform mode etc. Here you can set the inner radius (%) and 

| outer radius (brush size), the inner radius is the area of highest 

= Denm pS intensity; the outer radius is the area over which the pressure 
DRE Run ftw drops off. You can then set the max strength which equates to 
Grid Opacity 5 the pressure or how forceful the terrain moulding will be. 
Visible Level > 

El Deform Tool If you are struggling to see the grid, you can adjust the grid opac- 
FE 10 ity, this is especially useful when you start looking at using the 

E Round Brush tessellation brush. 
Enable Noise False 
NE 50 You can also set the mode of the brush, most of the time you 
Max Strength 50 will only need to raise or lower the terrain but sometimes you 
Noise Frequency 20 might want to have very angular odd shaped terrain then you 
Outer Radius 4.0 could use the Extrude along normals mode. Using the left lick or 

right click you can extrude or depress along the normals of the 


plane, experiment to see what | mean, it works most effectively on hills or already deformed terrain. 


The Platteau tool flattens the terrain to the same height as the place you initially clicked. This is useful in 
resetting the terrain to flat or creating plateaus for buildings etc. NOTE if you have extruded along normals 
your terrain grid will be deformed so just be wary of using in your level it unless you are sure. 


NOTE : You can always use ctrl + z to UNDO anything you have done 


The Smooth tool helps you to smooth rough slopes, it is best used in conjunction with the tessellation tool. 


The Tessellation Tool, allows you change the resolution of the terrain's mesh, increasing or decreasing the 
number of triangles a given region, Left Click to tessellate and Right Click to un-tessellate. 


Terrain Texturing 

When you want to texture your terrain it is a good idea to work out what textures you want to use, check 
out the wiki for a list with pictures (http://social.bioware.com/wiki/datoolset/index.php/Terrain list). Pic 
the texture you want, | will use ter swroots d. Select the Palette in the Resource Tree, right click > Insert > 


New Material. 


E) GS1100!llv! Interiorü1.lvl 87] GS1100Ilvl Exterior01.erf * 


s $ Terrain World 
=] e Terrain Mesh 


E- Pal 
cem me — —— 0 0 5 5 5 New Wind Object 


Ctrl+C 
Ctrl+V 
Del 


Once you have this you will have a resource called New Material in the Resource Tree. Select it and go to 
the Object Inspector. Set the Name to something descriptive, | will call mine TreeRoots. | will Leave the rest 
of the settings in General alone, but if you wanted to later you could go back and tweak things like the 
sound associated with the texture. UV Tile is basically the amount of tiling a texture has 8 is generally a 
good number for terrain textures, but play around the best tiling for the texture depends on what you are 
looking for. In this case I will set the UVTile to 8. Now | will select the diffuse texture and normal map, you 
can also set a specula map if you want, but for the moment | will leave it at None. Click on the Diffuse box 
and then on the "..." button to the right you can now look for your texture, | am looking for ter swroots d 
so | will start typing that. A good rule of thumb is that anything beginning with ter is a terrain texture. select 
ter swroots d, the d stands for diffuse. then click on normal and select the file of the same name with " n" 
rather than " d" at the end this is the normal map. Now my texture is ready!! Click on the Texture Paint 
button and you will see the new texture TreeRoots in the texture selection you can now select it and paint. 


Note: if you are looking to make your own terrain textures, check out the Material editor in better detail: 
. Itlooks like the editor allows for TGA 


textures so once you add them into the Art Resources databases you should be able to use them. If you 


really want to make your own textures you will have to investigate it yourself, we don't cover it in the tuto- 


rials. 


Once you have painted your textures you can tweak the texture settings as well as play with smoothing and 
relaxing the textures. 


Water 

Adding water to a terrain level is simple. Right Click on Terrain World in the Resource Tree and click Insert » 
New Water Mesh. Depending on what you want to do with your water you will need to adjust its heigh and 
size. We want to make a pond so we will move the water mesh just below our terrain layer (you may need 
to turn snapping off so it is only just under the terrain. Now we will use the deform tool to create a lake, 
remember right click, lowers the terrain. Now you have a lake, at the moment it looks a like a black pit, to 
fix this we will set up the area and it's lighting then come back to the water. 


Making an Exportable Area 


First select the Terrain world in the Resource Tree and  -,—:————— 
: P A Area Properties 
then click on the "+" button. This will open up a new E MEE E E E 
Area Properties window. Two things you MUST do ES 5i | Close | 
before you continue is set: Layout Name, this will be | El General : 
P $ y Area ID -1 
the name of the exported level file that you will use in 4 
p y Cutoff Height High (5.5m) 
the area, it must be unique and Name, this is the hu- Cutoff System Enabled False 
man readable name of the Area. Layout Name ¿name of exported layout 
Name New Exportable Area — 
Start Point Name Set MiniMap 
El Atmosphere - == 
Atmo-Sun Color [_]1.00,1.00,1.00 Default Map 
E Atmo-Sun Intensity 10.00 pM 
Atmosphere Alpha 1.00 Dj 
Distance Multiplier 1.00 =|| | Import Atmo 
Earth Reflectance 1.00 
Mie Multiplier 0.300 
Moon Alpha 0.00 
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What you will probably also want to do is Define 
the Area and Set the Sunlight. To Define the Area 
Click "Define Area". You will see a green square a 
yellow one and a red one these define the area, 
green defines the walkable space, you will want to 
make sure that this covers the whole area of your 
level that you want the player to walk on to do this 


left click and drag, the green section will snap to 


the level chunks. Once you have done that, you 
will want to set up the sunlight. Click on Set Sunlight the boxes will disappear and 
a blue circle with a red arrow in it will appear click and drag on the mouse to 
change the light Sun light's direction. 


Click close, now you have a workable area. 


Water - Part 2 

Now you have your lighting you can see the water. If the water is to large or too small you can select it and 
then set the X & Y size in the properties inspector under Water Mesh. I'm going to make mine a bit smaller 
because it is only a pond. When you scale down, one thing you will notice is that the water becomes more 
transparent, this is because the smaller it is the program assumes that it is shallower water, if you want the 
water to stay opaque | recommend leaving it a bit larger than you strictly need. You can edit some of the 
transparency properties in the Surface Colour section , but | have not found them to be that effective for 
small bodies of water. I'll set it back to 50 x 50 then go to the Surface Colour section here you can change 
the opacity fall off and the water's colour. The "Surface Color" window can be found in the object Inspector 
next to Properties and Wave Settings. | am trying to make the lake less transparent so | am going to set the 


Opacity falloff to 0.01 and the Water ect sper Se 
Clarity to 0.01 | am also going to desea Surface Color | 7 
BE 


E Specular settings 
Enable Specular On ' True 
Specular falloff 1.00 
Specular multiplier 1.00 


change the colour of the water to 


» 


something a little more murkey. | 
woudl suggest all the settings you can 


find in this window and in the wave Sunlight specular po 500.0 


settings, it will allow you to crontol Lain li 

how yor water appears in game much 1 
more. It allows you to not only set 
colour or transparency but wave size, 


the wtare normal map, the warters 
Current 


specular features etc. 


== 


Vegitation 

Now we will want to add some trees and grass to our level. To do that we will need to add some vegitation, 
pick which vegitation you wish to add then we will add it, see the wiki for a list 
(http://social.bioware.com/wiki/datoolset/index.php/Vegetation_list). | am going to use tre f oakhero and 


gra m gtall. To add vegetation to a level, you will first need to right click on the Vegetation heading in the 
Resource Tree then click Insert » New Tree Controller select the tre f oakhero, then add another and add 
the gra, m gtall. Now they are added select the scatter brush and you can 'paint' them onto the terrain. 
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Like the terrain brush you have a number of options here in the Object inspector including, minimum and 
maximum scale, density, fill rate and radius. The scale and density are useful in creating variation between 
vegetation of the same type, the large the difference between the maximum and minimum scale the great- 
er the size variation. Density is mainly useful for grass and shrubs, allowing you to have dense or sparse 
grass/shrubs. Have a play with these settings in the lab and see what happens. Once placed a tree/grass 
can be moved or deleted by selecting them and moving them with the move tools or pressing delete. You 
will probably also find that you grass/trees don't sit directly on the ground, you will have to move them so 


you don't end up with floating grass. 


If you can't see them when you first paint them on check your render view, it probably set back to 20m 


(Very small) and the vegetation is just not rendering. 


Lighting 

Now as we have sunlight we don't have to add another light source to external areas, though we can if we 
want. However if you have water in your level | recommend you use a light probe, it generates a reflection 
of the sky and surrounding objects in the water. To do this select the Water Mesh in the Resource Tree, 
Right click and Select Insert » New Light Probe. You might have to look around a bit to find it, it looks like a 
black spiky ball, you will want to position this in the centre of your body of water just above its surface. 
Once this is done render both the light maps and the light probe. Once this is done turn off the flat lighting 
and on the light maps. You may need to tweak and reposition the light probe till you have it how you like. 


Note: Trees don't cast shadows but they do reflect in bodies of water when you are using the light probe. 


Note: You will need to re-render the light maps after any changes you make to the area. 


Models 

As the Levels are static you can only place on them models NOT placeables. Click on the Model placement 
button then go to the palette window and click on the models button (blue cube). By default there are no 
folders in this area, however you can set up fake folders by clicking Tools > Options > Palette Window > 
Fake Folders = True. Now you can filter and search for any models you want and place them in your area. 
There are a huge range of models you can see them all here: 
http://social.bioware.com/wiki/datoolset/index.php/Model list, once you have placed them re-render 


your light maps and have a look. 


Correction to Last week: The Interior tiles are scattered within the list, you just have to find them, search- 
ing for floor/wall etc. 


This Lab, start building levels, both interiors and exteriors, we will get to exporting levels, walk mapping and 
areas next week. 
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Tutorial 3 
Path finding, Exporting Levels, Areas, Props & Items 


By now you should be able to create you own basic levels. Today | am starting you with a level that is al- 
most ready to go into the area editor. Place the file InteriorLevel.lvl in your toolset directory [Your Us- 
er]/Bioware/Dragon Age/addins/[Your Module Name]/assets/art. You do not have to place it here but it is 


useful for convenience sake. Once you have done that start up the tool- 
Palette Window - Model 


set, open [Your Module] then open the InteriorLevel.lvl. In this case we 


are dealing with an interior as they are less prone to error and are sim- OX 20m 
f" 8 B lg = $9 4 LL 


[Y] Books NN 


pler to export. When dealing with exteriors it can be a bit trickier. 


First thing you will notice about this level is that it is populated with [Only show resources checked out to me 
basic models. Lets add some more go into the models menu. Here you [Y] Hide folders 

can find the static objects that you will decorate your level with. To find 8 pic ferbookstck 0 

something you want search through the models menu. | am going to 8 pic shelfbooks 01 0 


8 prp booksta01 0 

8 prp btevbookshelf1 0 
8 prp ferbookstck01 0 
8 prp ferbookstck02 0 
8 prp ferbookstck03 0 


8 prp ferbookstck04 0 
for what you are looking for, or for things that will look like what you d prp tevbookshelfi 0 


look for some more books. 


Click on the object and move your mouse into the level view the object 
should be visible, now left click to place. The trick when you are looking 
for resources in the DA Toolset is thinking of as many words as possible 


are looking for e.g. if you are looking for a bench for a kitchen, look for a 8 prp tevbookshelf2 0 
bar or alter or table and find the object that best suits what you are 
looking for. 


NOTE: These models are static (you cannot interact with them) if you want to put an object in the level 
you interact with you need to wait 
till it is imported into an area. 


+ ¿[House Inter 


Next thing we need to do is sort out 
the walk mesh. A walk mesh defines 
where a player can and can't walk. 
The first thing we need to do is define 
a starting point. This is gives the walk 
mesh rendering tool a point from 
which to start the mapping. 


Now click the "Generate pathfinding 
for active area" button, it looks like a 
grey cog with a footprint in it. It will 
take a while but once it is done your 
level will be covered in red and green 
dots. They define the walk able and 
unwalkable vertexes. For interiors this 
is simple, however when you do this 


for exteriors it can be allot messier. If 
you wanted to tweak the walk mesh in an exterior you use "Build Terrain Collision Tool": 


46 


TIIIMDIPETIMM" Avalon Nigl w = + — BH BR., 


This will allow you to 'draw' a border around the places where you want the player to walk. 


In this tool you use left click to 'draw' one of these little walls and right click to remove it. Once you have 
finished your wall you can click the "Generate pathfinding for active area" button again and it will map out 
the new walk mesh. 
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Now you have your lights, objects and path finding done you can now export your level. | recommend re- 
rendering your light maps, light probes and path finding if you hadn't done it recently just so you know it 


how you want it. Then export the level! 


f LEE : 


Click on the "Export all to Local Post" this will take a while and the bigger the level the longer it will take. It 
is also here that problems arise so but be patient. If you come to issues sometimes it takes a toolset rein- 
stall or remapping. It can be a pain so just stick with it, it is worth the battle. When going between comput- 
ers you may have some issues transferring the area layouts. Make sure you keep the level files with you 
mod files so if there are any issues you can simply re-export the level. 


Now you have exported your level it is time to place it in an area. To do that create a new area File > New > 
Area. Make sure you put the area into your own mod directory; it makes it easier to keep tack of your re- 


sources. 
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Resource GSInterior 


Folder \_GSTUT\ 


Module |Game Studio Tute 


Owner |Game Studio Tute 


State | NONE 


Attributes [Y | Checkout resource after creation 


It is important that you remember the Layout Name you chose when you set up your area; we will need 
this when we choose the area layout. Go to your Area's properties in the Object inspector and click on the 
Area Layout Box. 


Look In rm All Game Resources 
arena brc300d den009d den308d dens05d hrt201 
arena2 brc501d den011d den312d den510c hrt201 
avelüin brc502d den012d den400d den510d isound 
ave200d brc503d den020d den401d den520d lak100| 
avisle brc504d deniüid den403d den600d lak100 
brco00d brc505d den200d den404d den601d lak100 
brc100d brc997d den200n den405d den602d lak101 
brcioid brc999d den201d den407d den900d lak102| 
brc200d combat den202d den408d den901d lak103| Object Inspector “a, ax 
brc201d combat2 den203d den500d den998d lak104 Ta: 
brc202d den000d den204d dens01d hrto00d lak105 ES 24 
brc203d den001d den206d den502d hrt001d lak106 B Genera 2 
brc204d den005d den207d den504d hrt002d lak107 
mm Area Layout 35] 
AreaList None 
ltut100d| 
Comments 
Filter | Layout Files (*.arl) Name 3 
NameRequiresRe False 7 
Resource Name |gsinterior 
F Script area_core 
x 
Variable 2da var area 
= Variables Variables 
=| | Actions 
)d\Textures\' No Teleport True 
E Audio 
Music Preset None m 


~ | Area Layout 
Specifies the art environment to be 


ATE 


Select your layout; it will load; now you can start the next stage of your mods development. 
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Areas 


Playing Your Area 
We covered this in the scripting tutorials but | will go through it again. 


Right click In the area and select Insert Waypoint 
Now you can place the waypoint wherever you want the play- 
er to start, it must be within a walk able area. 

3. Go to the Tag of the waypoint and call it "player start", Go to 
the Waypoint Name and call it "StartWwP" 

4. GotoFile » Manage Modules. Select [Your Module] and click 
on the properties button 

5. Setthe Starting Area to the area you have chosen in my case 
it will be "gsinterior" and set the starting waypoint to "play- gp 

er start" then OK. 


6. Check In the area by right clicking on the resource in the re- 


Insert Music Volume 
Insert Reverb Volume 
Insert Waypoint 


Properties 


source tree and click "Check In" 
7. Oncethe Resource is checked in, you can export it. Right Click on the resource » Export » "Export 


without dependent resources" WETE F 


MEERE 


8. Now Ifyou are running this at home all you need to 


do is launch Dragon Age Origins and click on "Other - 
3-14 Global 


Campaigns" and there you have it your first playa- =a GSTUT 
8 avel00are_2 
MA acinterior! 


++ 13 Global View Resource 


Export with dependent resources 


4 GSTUT 


8 avel00are_2 
—_— | 


View Resource 

Open Local Copy 
Duplicate 

Diff to Last Checked In 
Resource History 

Check Out 

Builder To Builder Create 
Refresh F5 
Refresh (No Art) Shift«F5 
Refresh Override  Ctrl+F5 


Delete 


Export 


Export without dependent resources New 


Export all resources of type 
Full export 

Empty Export Directories 
Generate Module XML 
Generate Manifest XML 
Export Talk Table 

Export Foreign Talk Table 
Export Options 


7 Properties 
Map! lote 
MapNote enable False 
oNote type | Default 
tequire False 
StartWP 
player_start 


Attributes 
Colour blue 


ble level. 


Open Resource 

Multi-Edit 

Duplicate 

Diff to Last Checked In 
Resource History 

Undo Checkout 

Builder To Builder Create 
Refresh F5 
Refresh (No Art) Shift«F5 
Refresh Override — Ctrl «F5 
Export 


New 


T Properties 


50 


Placeables 

Areas are made up of interactive objects, such as 
doors chests etc. To start with we are going to cre- 
ate a door placeable. It is important you get used to 
the process we use here both for the first and se- 
cond variations of placeable item as this process is 
the same one you will use for items, characters etc. 


File » New » Placeable 


As before make sure to place it in your 
module folder, give it the name of InteriorDoor1 or some name relevant to your module. It would 
probably also be a good idea to place the door within a door or transitions folder, depending on 
what sort of door you are creating. 

3. By default the start up placeable is a door. There are two types of doors in the DA toolset ones that 
simply open and others that work as area transitions. We are looking to have doors that just open 
but if you were looking to make an area transition. Change its appearance to one that starts with 
the prefix Area Transition. 

4. Forthe moment we will simply save the place able, check it in (Right click » Check In) and place it 
within the area. Select the resource in the resource tree and place it in the area. Rotate and posi- 
tion it to suit, remember that on simple doors the arrow points in the direction the door will open 
for transition al doors it points in the direction you want the player to go. 


Now lets try making a lootable object, in this case we will make a chest. 
Now we could go File » New »Placeable again, however there is an easier 


way. Go to the placeables menu and do a search for a chest. Find a chest = 
| Only show resources checked out to me 


you like then right click » Duplicate. | Hide folders 
14 Global 
=)“ Containers 
(8 genip chest half buried (C 
This will open up the placeables editor. Go down to Inventory List and 8 genip chest iron (Chest) 


This will create a new placeable chest with all the associated behaviors 
and scripts of a chest, remember to save it in your mod's file directory. 


click the "..." button that comes up. Now you can add items to the inven- a -—— 
tory, | am going to add a dagger. | am going to go into. Global » Weap- View Resource 
ons, melee > Daggers and add a dagger. Once | have added the item to Open Local topy 


the inventory, saved the place able and checked it back in I can place it i 
Diff to Last Checked In 


Resource History 


Check Out 


into the area. Now the dagger is in the chest and you can loot it. Run the 


game and check it out. 


This process can be used for all placeables, duplicate add them to your Bulder To Bürde Create 


Refresh F5 
Refresh (No Art) Shift+F5 
Refresh Override Ctrl+F5 


mod. If you have decided to edit the object after you have checked it in 
merely check it out (Right Click > Check out) and work on it, but remem- 
ber to save it and check it back in so you don't loose any of your work. If 


you are planning to manipulate any of the objects with scripts it is im- 


portant to give them a unique tag and to associate the script with them in DEET 


the placeable editor. Epot 


New 
Items 


"T Properties 


We have placed items in a container, but what if we needed to make our 
own items, such as tinted armor, a key or a special weapon. This is how you would go about it: 
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1. File» New >ltem, in this case we are going to work with the default item, a long sword. Remember 


to place the item in your mods folder. 


2. Setthe tag to something relevant to your mod. You can also set the description and item name 
here e.g. "The Sword of Mr Fluffy" 
3. Now you have a new long sword. First thing | want to do is alter its appearance you can do this us- 


ing the "Item Variation" property, pick one you like, | am going with Long sword 4. 


4. Setthe base cost for the item, it is a good idea to base it on similar items, in this case we will use 


the long sword cost of 1500cp 


5. |tem Properties is where the fun really begins. Here you can add special attributes to the item. 


Have a look through the list. 


6. Saveand Check In your new Item. 


7. Now you should be able to add this to your chest's inventory. | found that | had to reboot my tool- 


set for the inventory of the chest to see my new items, but hopefully you don't have to. Add the 


item to the inventory of the chest and test it out. 


qe 
MaterialType 
Name 
NameRequiresReTranslation 
R ^ Name 
Tag 

Tint Override 
Attributes 
Body Tint 

Body Tint Mask 
Cost 


OnHit Power 

Plot Item 

Script 

Unique 

Variable 2da 

Variables 

Model Appearance (R/O) 
Model Appearance 
Model Gender 


em Properties 


Default (Armor, Gray Iron) 
The Sword of Mr Fluffy 
True 


gssword 
(none) 


Green 
(None) 
1500 


Item Properties Properties E 


ni 


var item 
Variables 


Human 
Male 


USEFUL LINK: Re-tinting Items 
http://social.bioware.com/wiki/datoolset/index.php/Tutorial: Creating recolors of existing items 


increase Cunning 

Increase Damage 

Increase Defense (3 per power) 
Increase Defense against Missiles (2 
Increase Dexterity 

Increase Electricity Resistance 
Increase Electricity Resistance (5 pe 
Increase Exploration Health Regen 
Increase Exploration Stamina Reger 
Increase Exploraton Mana Regen 
Increase Fire Resistance 

Inc se Fire Resistance per puv 
Increase Healing Spells (596 per po 
Increase Magic 

Increase Melee Crit Chance 
Increase Mental Resistance 


Inrroaco Natural armar 
It 


Abilities 


Type Property Po... 
[A] Increase Attack (2 per power) O 
[A] Increase Combat Health Re.. 0 
[A] Increase Constitution 0 
[A] Increase Healing Spells (5%... 0 
A] Increase Fire Resistance (5 p... 0 


You have reached the 5 Ability properties limit. 
To add a new one, you first need to [Remove] 
one. 
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Tutorial 04 - Area Transitions, Conversations Part1 


Area Transitions 


Last week | mentioned setting up area transition doors , through creating a new placeable and then using 


the Appearance = "Area Transition, [Door Name]". In this weeks example you can see this in action. When 


you are ready to set up the transition there are two things you need to do. If yopu want the transition to be 


two way, e.g. you can go out and come back in, you need to set up a Waypoint on the inside of your area 


near the door (or where ever you want them to transition to) by right clicking » insert Waypoint. You then 


need to change two of the variables in the doo's variables list by clicking on the doors variables property. 


e PLC AT DEST AREA TAG - tag of the destination area 


e PLC AT DEST TAG - tag of the destination waypoint within the destination area 


General 

Appearance Area Transition, Ferelden Small 
Character (None) 

Comments 

Conversation (None) 

Group PC 

Name 

NameRequiresReTranslation False 

Plot False 

PopupText 

PopupTextRequiresReTranslation False 

Rank INVALID 

Resource Name tu 

Script placeable core 

Tag tut340plc transdoor 
Team -1 

Treasure Category INVALID 

Variable 2da var 


Variables 


PLC COUNTER 1 

PLC COUNTER 2 

PLC COUNTER 3 

PLC DO ONCE A 

PLC DO ONCE B 

PLC AT DEST TAG 

| PLC FLIP COVER USE COUNT 


PLC TRAP. TYPE 

PLC AT. WORLD. MAP. ACTIVE 1 
PLC AT WORLD. MAP. ACTIVE 2 
PLC AT. WORLD MAP. ACTIVE 3 


Auto Remove Key 
Key Required False 


ariables 
isplays the table selected in the "Variable 2da” field. Allows setting initial 


PLC AT WORLD. MAP. ACTIVE 4 
TS OVERRIDE CATEGORY 


TS OVERRIDE RANK 
TS OVERRIDE MONEV 


int 
lint 
int 
int 
int 


string 
int 


int 
string 
string 
¡string 
string 


int 


Default 


| [PLC AT DEST AREA TAG string none 


0 


Once this is done you can check in the resources and place the doors and your transitions should be 


smooth. Most placeables can serve as area transitions, the reason we use the area transition door is so it 
doesn't open into the infinite blackness of the end of game world. Theoretically you could easily hook an 


area transition to a bookshelf or any other placeable object using the two variables listed above. 
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Conversations 

This week we are skipping ahead to conversations as most teams were interested in using them as a pivotal 
part of their game play. Conversations are an important part of the RPG style game and subsequently the 
DAO engine has a comprehensive conversation editor. However it doesn't function totally on its own there 
are number of other tools that link in with the conversations editor that make the conversations side of 


DAO work. They include Creatures, Plots, Scripts and Stages but first let's get into basic conversations. 


DA Conversations 101 


Before you even think about building a conversation you need PERSH TETE [ox] 
to think about the way conversations work in RPGs. Many of \GsTUT\Conversations\ [| 
you will have started working on linear conversations and Game Studio Tute 

while this allows you to get from point a to point , it doesn't Game Studio Tute 

allow allot of room for the player to customise their game play WS 

experience. Conversations in the toolset work on a tree meth- pire B odeur resource aier creation 


od it starts at the root and branches out, it can loop back on 
itself and/or can go off on varying tangents. A good way to start thinking about writing your conversation in 
trees is start with 2-3 different PC types such as: the always good hero, the angry hates the world anti-hero 
and/or comic relief hero. Start writing the conversation with this in mind write a response suited to each PC 
type and the NPC responses. This allows you to have a linear style conversation while still giving the player 


a unique game play experience. 


To create a new conversation go to File > New > Conversation, create the resource, remembering to put it 
in your mod's directory. 


Now you are in the conversations editor. | do not have time to go through all of the menu items in this tute 
however on the next page is an image from the wiki that shows the menu items and their functions. Now to 
start off with just want you to click on the root tag (by default it is selected when you create the conversa- 
tion) and have a look at the screen. Below the main conversation window you have a tabbed pane, this is 


where the extra functionality is set. 


a - 6? uut. 5ugg4seg ts €e.»2*»$2.-0.V E 
L- tut360con_bobsboots.dlg t + X Palette Window - All > 

$912 6 19% 

^z5gHMens.(€ 


” 


p Followers 
$a Game Effects 
+= Generic 
Ha Global 
3 GSTUT 

+ Gi Area 

$ Ga Armour 

+ 23 Container 

Ca Conversations 
“8 tut360con, bobsboots.d 


$ C3 Creatures 
$ C3 Plot 
bre $ $ Q3 Transition 
Sethngs Plots ond Scrigeng | Onematics | Preview Conversation Synopsis 3 G3 Weapons 
Mout MPC Speaker Tag OWNER vi i Lock Al Gestures Owner Is Henchman t 15 U 
Lock All Poses VO Hard Time Restrictor Object Inspector > 
Hoult MPC Listener Tog PLAYER e = ioc 
Lock All Robobrad ms 
Wait PC ener Tag OWNER "| Lock Al Cameras d 
Ambient Soundset Type Resource Name tut360con_bobs 
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NN “e, % %, GA Cy, by Qo CT. % o 
3 A ACH EN UN bo A n i 5 a. 
toy Ca a R, eOe À a th “e, 
e “fe, Ca e o d K 
t 
Global Settings 


This is where you set the main speaker and listener for the conversation, you can add in extra characters 
later, but these are the main ones. By default the main speaker is the NPC the conversation is associated 
with and the default listener is the PC. There are a bunch of other options in this window such as locking 
some of the features like Cameras or setting the OWNER to one of the player's Henchmen, | won't be going 
into these today if you are interested in exploring them try them out and see what they do. 


Plots and Scripting 
This is where you can set default plot or script events at the end of the conversation, this means that no 


matter where or how the conversation ends certain things will take place, you don't need to apply them to 
all the different end nodes of your conversation. 


Cinematics 
Where you associate your stage with this conversation. 


Preview 


| haven't used this aspect of the toolset but it appears to be a quick way to link up a conversation to an area 
and NPC to preview the conversation. 
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Writing the Conversation 


You now have a rough idea about what you are going to write, so right click on 'Root' in the conversation 
window and "Insert Line". If you de-select it you will see it is red. This is the first NPC line select it again and 


write a welcome in the dialog box. If you examine the tabbed pane down the bottom it has changed you 


now have a range of extra features. 


A note if you need to translate the 
line into another language or if you 


are waiting on a voice recording. SRE 


wW Traveler, how faros thee? 

f a line of 
conversation : 

: ext requires re-translaton Not translated yet. M No VO In Game 
requires a 
»articular skill [A Text requires re-recording (VO) Not VO Recorded yet. Narration 
thr .B- f 
eee una ((None) *| Language [Common 


Checked if there is no voice over going to be suppied for this line of 


a 


persuasion or 

sunning this |f Speaker Tag 
con is used to 

ndicate that 


(defaut) - 


1D: 1648245864 Letters: 33 Conversation Words: 5 


Set a custom speaker and listener for this line of 
conversation, Allows for a conversation between two NPCs 


Sets the in game 
language of the 
conversation e.g. 
Elf, Dwarf etc. 


For the moment we are going to leave these be and just write some more lines. Right click on the line you 
just wrote and select "Insert Line". This is your first PC Line, you will notice it has [END DIALOGUE] written 
in it. It is important to note here that only PC lines can end a conversation, if you want to finish the conver- 


sation with the NPC just insert an empty PC line like this one. Now we can add some text here | am going to 


go for the nice hero first and write some pleasant response. Now if you right click on this line and select 


"Insert Line After" it will add another PC choice, in this one I will add something a little more hostile. If you 


click on these lines and click "Insert Line" you can add an NPC response and continue on that way. If you 
are designing a conversation between two NPCs and want to skip the PC line you still have to put it in but 


just leave it empty and add another NPC line and it will become a ‘continue’. 


One thing you will find in RPGs is that you will often want to allow the player to investigate things so bring 
them back to a range of options or bring the conversation back to a single ending point. To do this without 


having to re-type all the lines the DAO editor has line linking system to create a link select the line you want 
to link to and copy it either through ctrl + c or right click > copy. To link the line select the line you wish to 


link to the line you just copied and paste the link by right clicking > Paste as Link or ctrl + shift + v. 
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4p tut300are convo.are $- tut360con bobsboots.dlg 


= Root 
CB [([OWNER]] Welcome Traveler, how fares thee? 
EU) Well thank you and you? 
| 0B [[OWNER]] Alas not so well. 
E here anvthing er (10) TO e 
cM It just got a whole lot worse now I have to talk to you! 
cal [[OWNER]] My appologies, I meant no harm. 


| [Now you have disturbed me what do yi 


Copied line 


Insert Line Ctrl -A 
*» InsertLine After — Ctri«Shift-A 
y Expand All 
“3 Collapse All 
*a Expand Branch 
3 Collapse Branch 
+) Expand f 


Dialogue | Plots and Scripting | Localization | Editing 


Now you have disturbed me what do you want? 


Preview Line Alt+Help 
sé Generate Gestures for Children 


Clear Gestures for Children 


("| Text requires re-translation Not translated yet. B | 
q 24 Process Cameras for Children 


E] i - i Not VO Ri ded yet. = E 
_|Text requires re-recording (VO) No ecorded ye Count NPC Lines in Branch I 


Skill/Icon | (None) =a Copy Ctrl+C | 
PLAYER ZA Paste Ctrl+V 
Paste as Link Ctrl+Shift+V 
ID: 1648245871 Words: 9 Letters: 43 Conversation Words: Delete Del 
a% Find Links Alt+L | 


Once it is pasted it will appear grey, if you wish to edit the line of text you will have to go to the actual line 
and edit it any changes will be reflected in the link. If you wish to delete a link or a line of text all you need 
to do is right click > delete or select the line and press the delete key (fn +delete on a boot camped Mac). 
Finish off the conversation save it and check it in. 


In the demo levels | have provided | have created a custom creature, Bob to add a conversation to a crea- 
ture you need to edit it's template, | will be doing creatures and characters next week so for the moment 
just use bob. Edit his template and add the conversation you just created to his conversation property. Now 
you can export the resources and run the game and talk to Bob. Nothing exciting there but a repeated con- 
versation, very rarely will you want a conversation with no game relevance so now we get on to the more 
interesting bits. 


There a number of formatting featured provided for in conversation text formatting such as «emp» </emp> 
for emphasis you can see a list of them and other in text features here: 


http://social.bioware.com/wiki/datoolset/index.php/ConversationttFormatting tags 
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Conditions & Actions 


Now in the above section we made a conversation with no special features, most of the special features 
need to be added through a combination of script and plot driven: 


e Conditions - if true/false the line is spoken; and 
e Actions - after the line is spoken an action takes place. 


Generic Conditions 

but there are a range of generic conditions and actions in the DAO editor to get to them click on the ... next 
to the plot Condition/Action go to Global » Generic and you will see them. Select one and it will have a 
range of condition options in the Flag drop down e.g. 


Dialogue | Plots and Scripting | Localization | Editing | Cinematics | Animation | Preview | Slide Show | 
Condition 


Plot genOOpt class race gend v "m 
Flag (None) 


(None) 
Action GEN_CLASS_ADV_ARCANE_WARRIOR (Defined) 
GEN_CLASS_ADV_ASSASSIN (Defined) 
Plot GEN CLASS ADV. BARD (Defined) 
GEN CLASS ADV. BERSERKER (Defined) 
GEN CLASS ADV. BLOOD. MAGE (Defined) 


set Md 


GEN CLASS ADV DUELIST (Defined) 
GEN CLASS ADV. RANGER (Defined) 
Visibility GEN CLASS ADV. REAVER (Defined) 
GEN. CLASS, ADV. SHAPESHIFTER (Defined) 
———— GEN CLASS ADV SPIRIT HEALER (Defined) 
search Re GEN CLASS ADV. TEMPLAR (Defined) 
= GEN CLASS DEF BLOODMAGE OR, REAVER, OR, ASSASSIN (Defined) 
Search ‘cen Ci Ass MAGE (Defined) 
GEN. CLASS. ROGUE (Defined) 
GEN. CLASS, WARRIOR (Defined) 
GEN GENDER, FEMALE (Defined) 
GEN GENDER. MALE (Defined) 
GEN RACE. DWARF (Defined) 
GEN. RACE. ELF (Defined) 
GEN RACE. HUMAN (Defined) 


The same works for generic actions: 


Dialogue | Plots and Scripting | Localization | Editing | Cinematics | Animation | Preview | slide Show. 


Condition 


Plot gen00pt_class_race_gend v "m Scrip 

Flag |(None) Z 

Action 

Plot gen00pt_combat = "m Scrip 
None 

Line Set | 


Visibility Normal line v ay: 


search Results Window 
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However these generic features are very basic you will definitely want to add more Conditions and Actions 
using your own Plots (Quests) and Scripts. 


For more info on Generic Conditions see: 
http://social.bioware.com/wiki/datoolset/index.php/Conversation plots and scriptingitGeneric condition 


S 


Plots 


Plots are quite a complex topic and have a range of different functionalities, however we will be mainly us- 
ing them for their quest and journal features to read about the range of plot related features check out: 
http://social.bioware.com/wiki/datoolset/index.php/Plot 


To create a new Plot go to File » New » Plot. Create the new resource remembering to put it into your 
mods directory | am going to call mine "tut370plt BobsBoots". Right Click in the main window and click 
insert > Main Flag or ctrl + m, you have your first flag. Change the Name from FLAG O0 to FIND BOOTS with 
it selected look to the bottom half of the window you will find a box titles Journal Text, type in it the text 
you want to appear in the journal. Go to the Properties Window and Select the Name field type the name 
you want to appear in the journal, | will type "Find Bob's Boots." You can also set a number of other proper- 
ties here, have a look some of them may be useful for you. I will set the Priority for this quest to High, when 
you are making your mod you can set side quest to a lower priority and main quests to a higher and the 
journal will sort them in order of priority. Insert 2 more Main Flags 


e BOOTS FOUND, Journal: "You have found Bob's boots, return them to Bob" 
* BOOTS RETURNED, Journal: "You have returned Bob's boots and gained his gratitude" 


In the last Flag set the property Final to Yes, this will move the quest from the active quest tree to the com- 
pleted quests tree. You can also add a reward, the rewards are predefined in the Rewards.xls 2DA file so if 
you want to create your own you will have to do it through this (see: 


http://social.bioware.com/wiki/datoolset/index.php/Rewards.xls & the Plots link above). For the moment I 


will set the reward on the final entry to the string reward just to show you how it works. 


Save it and check it in, now go back to the conversation with Bob. Go to the your final lines and go to the 
lines Actions > Plot, click on the ... go to the folder you saved the plot we just created in and select it, using 
the drop box click on FIND BOOTS. 


Now the Conversation gives you the quest, but we want to stop it from trying to give it to you twice. Go to 
the first line of the tree and add a Condition. Go to Conditions » Plot Select the same plot file we just creat- 
ed and the FIND BOOTS entry but instead of "is true" select "is false". Now this line will only be said when 
we don't have that particular journal entry, this is not really the best way to do it as we have more than two 
entries, however for the moment it will do. Add a new line for Bob from the root "Have you found my 
boots?" put a yes & no PC reply. 


If you save it, check in all the resources, export it and run, the conversation with bob will run he will give 
you the quest then if you talk to him again he will ask you if you found his boots. Now you could just add 
the Found boots final quest update to the PC Yes line in the second tree, however you probably want to 

check if the player actually has the item which means we have to move into the realm of scripts. 
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Scripts 


As the artists and designers here may not really like code, | have created a importable database with a cou- 
ple useful conversation scripts. 


Scripts for conditional statements, which is where you will really want to use them, are a special form of DA 


function that don't require a main() e.g.: 


int StartingConditional () 
{ 


return 1; 


} 


The first script | have given you is "conversation_inventroycheck" it checks the inventory of the PC and re- 
turns true if it contains the item of a specified tag, | have also put a link to an example script for checking an 
entire parties inventory in the comment at the top: 


int StartingConditional () 


{ 
object oPC = GetMainControlled(); 


/* change the string in the below function to your own 
object's tag*/ 


object oItem = GetItemPossessedBy(oPC, "bob boots"); 


if (IsObjectValid (oItem)) 


{ 
return TRUE; 


} 


return FALSE; 


Import this script from the database and add it to your module folder, go to the conversation tree and se- 
lect the yes option add the conditional script to it. Add the Final Plot Flag from the Plot we wrote earlier to 
the actions of this line. Now also add a Plot conditional to Bob's "Have you found them?" line: 

BOOTS RETURNED is false. It might also be a good idea to add another line for bob off the root that just 
says "Thank you for finding my Boots". 


Save, check in, export and run. 


You will notice that the character is a bit wooden with no animations etc. To fix that you will use stages but 
as they are a polishing aspect we will be covering them in a couple of weeks. 


60 


Tutorial 05 


Visual Effects 

We have discussed level building and you all should be well on your way to having your levels built. This 
week | am going to go back to levels a bit and touch briefly on visual effects (VFX) which can be added to 
you levels to add atmosphere as well as a more dynamic feel. | will also provide a list of links to the VFX 

parts of the toolset wiki for those interested in using them with characters, spells or creating their own. 


First off | am going to add a fire place to my interior, models = fti fireplace a O. Place it where you want 
it, we are just using it for a context for the effect. Now go to the models filter and search for fxe fire. The 
fxe stands for environmental effects, there are a number of prefixes and suffixes you should be aware of 
when dealing with effects they are: 


H hd *" 4 —^ m — wy uw 
Prefixes: *2BEORO nEn 
E) tre fire 
» Only show resources checked out to me 
e VFX - general visual effects Z] Hide folders 
bxc él fxe fire cnd p ^ 
e FXA- abilities EME 


Q fxe fire | ns p 
fxe fire large p 


e FXE - environmental 


fxe fire Irg p 
e  FXC- character entume 
E 
M FXP - placeable (4 ixe fire medium p 
. @ fxe fire small p 
e  FXM -animator cut scene vfx 8 fxe fire trch ost p 
$ (3 fxe fire wall p 
e SR - GUI/selection 8 fxe_firewall_p - 
Object Inspector ax 
Suffixes: ee 
Export to Game True ^ 
Lightmap True 
e  p-placeable, can be placed B Graphics 
. Cut Away Overric None 
anywhere in the scene. DetauftArimsto 
e  c-crust, should be attached —— EN E 
toa model. | LL € 
| 
Show High LOD False 
We will be dealing with — — 
exture Size Mul 
fxe fire med p a medium fire envi- B Location : 


ronmental effect placeable . Place 

your fire in your level and position it within the fireplace. You will notice the fire is too big, however if you 
go for fxe_fire_small_p the visual effect is too small. So what we will do is scale this effect. once you have 
placed the effect select it and go to the object Inspector scroll down to scale and set it to 0.6, or whatever 
best suits your chosen fireplace. | would then add an animated light click on the room that your fire is in 
right click > new >light. Set the light type to point animated. Set the colour to something with a red-orange 
tint. | would then go down to the Animated section. Here is where you can set the frequency and intensity 
of the flicker. | am going to leave most of it as is but change the minimum intensity to 1 so that the differ- 
ence between the max and min in the flicker is more noticeable. | am also going to set the Light Character 
property to true so that my character is illuminated in the flickering light. Now you can add your start point 
and export, when you import it you will have a fireplace that illuminates the room and the characters with 
a flickering orange light. 


VFX Links: 


e VFX List: http://social.bioware.com/wiki/datoolset/index.php/VFX list 
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e VFX Tutorial: http://social.bioware.com/wiki/datoolset/index.php/VFX Tutorial 
e VFX editor: http://social.bioware.com/wiki/datoolset/index.php/VFX editor 


Creatures & Characters 


Creatures and characters are two different things though a Creature may be a Character. 


Characters 

Characters are basically a human focused definition of a creature. It was created for the DA:O development 
team to define a character's background, family etc for voice actors and other human contributors. It is not 
used directly by the DA:O toolset. If you are interested in reading more about characters | suggest you look 
up the character blurb on the wiki: http://social.bioware.com/wiki/datoolset/index.php/Character. 


Creatures 
http://social.bioware.com/wiki/datoolset/index.php/Creature 


Creatures are all the NPCs, animals and variations thereof in the game. If you wish to use a default creature 
with default behaviour e.g. a hostile darkspawn, then you can simply go to the creatures menu 

( Core creatures » Darkspawn » Hurlocks » Normal » hurlock axe) and place the creature where you want 
it, by default they are hostile and will attack as soon as they perceive the player. However if you wanted 
something a little more 
customised, you will have 


 interiorfire.are $ tut_customcreature01.ute| 
to create your own crea- ies Se —— 
ture, so let's do that. BE 
El General a 
Character (None) e: 
There are two ways we can z a 
Class Warrior 
do this the first is to find a Comments 
Conversation (None) 
creature that has the be- r i 
opper 0 
haviour or appearance we Description 
: y DescriptionRequiresReTranslati False 
want and then right click - 
ender Male 
and duplicate them or we Group -Neutral 
: | Interactive True 
can go to File > new > Crea- Inventory Inventory 
ture. In this case we will Name 
NameRequiresReTranslation False 
create a new creature from Perception Range PercepRngMed 
scratch. Plot Giver False 
Race Default (Human) 
Resource Name tut customcreature01 
Tag tut customcreature01 
Team -1 
Variable 2da var_creature 
Variables Variables 
B Abilities 
Skills Skill 


Snallc Snall 
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Creating a Creature from Scratch 

The first step of creating any creature is working out what you want to create. That is one of the useful 
parts of the character tool, it allows you to create a full profile for a creature. | would recommend you use 
it when you are creating your core characters, but it is not necessary. The core thing here is that you need 
to know what you want to create. | am going to create the first version of a creature that will reoccur 
throughout my game. This is the profile: 


+ Name: Mordred 

* Gender: Male 

e Description: The Son of Arthur and Morgana Le Fey, a vengeful and dark character who will stop at 
nothing to attain his father's crown. 

e Class: Arcane Warrior 

e  Plot/Quest: Dark victory - Steal Arthur's sacred scabbard. Final boss 

e  Group/faction: LeFey (new groups created in the 2DA file: 
http://social.bioware.com/wiki/datoolset/index.php/Creature group); 


e Tag: mordred openq 
e Skills: Master persuasion, master survival, master combat training 
e Spells: Aura of might, shimmering shield, fade shroud 
e Talents: 
Assassin: Exploit weakness, mark of death, 


o  Dualist: all 
o Warrior: Death blow, perfect strike, precise striking, disengage 
o Two handed: Critical Strike, pommel strike, powerful swings, stunning blows, two handed 
strength 
e Appearance: fair skinned, dark hair and stubble, green eyes, tall, lean 
e Min Skill: 8 
e Max Skill: 15 
e Rank: BOSS 


e Plot: True 
So now we will implement this. 


| generally find working from top to bottom a good idea, others like to set up the appearance then imple- 
ment the more technical side, it is up to you. There are a few things | want to talk you through the first is 
equipment. Your creature starts off without any equipment and almost naked, to put clothes on them we 
need to go to the inventory section. Find the equipment/clothes you would like to equip and place it in the 
inventory. Once you have placed it in the inventory you can equip to an equipment slot. you can also set it 
to drop able and or steal able in this case we do not want his gear drop able or steal able as it is the first 
time we are meeting this character so we don't want our low level PC getting his high level gear. We'll not 
put on his helmet in this case as we want to have a conversation with him so we will leave that off for the 
moment. 
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E | Inventory 


+O Debug 
+@ Global 
@ _GSTUT 


+ 


+1 Background - Dwarf Noble 
+ @ Background - Elf City 


$i CJ Landsm 


eet (Denerim) Remove 


+ £3 Light Content 


+) £3 Nature of the Beast 


y CJ Paragor 
+ U Prelude 


$42 Sacred Um 


Store Panel 


Remove All 


n of her Kind 


@ Rem Palette 


Label 


gen im arm bot m.. 

gen im arm cht ma... 
gen im arm glv ma... 
gen im arm hel ma... 


3 Group: Weapons 


Sub... 


Slot 


3j Group: Armour 


324000 
334000 
314000 
304000 


Set 


Stack... Drop... 


Steal... 


Cancel 


It is best to set up your skills, talents & spells to suit the character you are creating as Mordred is being de- 


signed as a major boss, we want him well set up, with a combination of magic, underhanded and warrior 


skills (see list prev. page). 


Next we get to appearance. 


Head morphs 

One of the key aspects of character appearance in 
DA:O is the head morph. What this does is allows 
you to create a custom looking head for your crea- 
ture. Often you will just want a random generic 
head and then you can use the head morphs in the 
DA:O engine however for your unique characters I 
generally recommend you create your own head 
morphs. Go to File »new > morph. Go to the drop 
down at the top of the window and choose the 
base, in our case it will the HM or human base. If 
you want a quick random head morph and you 
don't care you can use the randomise button to 
randomise the morph, but you will still have to put 
on hair etc. Now you can put as much or as little 
time into tweaking the morphs as you want there 
are a huge range of options to choose from when 
you start working on it. If you are looking for more 
info on morphs including screen shots of all the 
presets (hair, eyes etc) check out the morphs sec- 
tion on the wiki: 
http://social.bioware.com/wiki/datoolset/index.ph 


p/Morph 
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File | Edit View Tools Window Help 
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3 Open File 


Save As 


Close 
Close All 
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Restore Environment 
Recent Files 


Exit 
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©) MordredO1.mrh| 


* |Palette Window - Character ox 


er Does r.GarBsbBowgonrss 
> 

Only show resources checked out to me 

Hide folders 

23 Monsters a 
@ abomination 
@ arcane_horror 
@ archdemon 
@ ash_wraith 
@ bereskarn 
@ black bear 
8 blight, wolf 
@ bronto 
4 broodmother 
8 cat 
@ deepstalker 
8 deer 
d desire demon 


OL Material | 02. Part selection | 03. Feature Selection 04. Nose | 05. Mouth 06. Eyes 


B 01. Face ^ 


01. Skin Color ti skn 002 
MX 02. Lip Makeup Color t1 mul br3 

- > 03. Lip Makeup ty 47 
Success, 0 Skipped, 0 Failed. Please see below for more details ^ 03. Lip Makeup Opacity 047 
successfully. 04. Blush Makeup Color 

3 successfully. 05. Blush Makeup Opacity 0.44 

ve Make lo e 

for resource: Mordred01.mrh 06. Eye Makeup Color t1 mue gni 
nnaMDocuments BioWare Dragon Age\addins\GSTUT\core\override\toolsetexport\hm_mordred01 07. Eye Makeup Opacity 0.34 


Once you have achieved the look you want you will need to export it, remember to save the morph art file 


in case you want to work on it later. Right click on the morph and click post to local. 


Post to Local 


4&4 Zoom To Object 


NOTE: the file will export hm [your File Name].mor and will be 


saved in: Dragon Age\addins\[Your 


mod]\core\override\toolsetexport 


Now that it is exported you can go to the creature, click on the 
head morph property and place your new head morph there. After 
that is set the final features are the Max & Min Level. This has to 
do with the range of levels this character can have scaled in rela- 
tionship to the PC. e.g. if the PC ends up battling with this PC and 
they are level 5 then this character will be scaled down towards 
the minimum side and vice versa. The Package sets the default 
scaling and much of the Al in this case we will set it to Human 
Two-Handed, we will set the Package Al (the 2DA that contains the 
tactics table) we well set to the API two handed human, and set 
the rank to Boss. For this section we need him to be a plot charac- 
ter, which means he cannot be harmed in battle. For a later incar- 
nations we will change this so we can have the final battle with 


him, but for the moment we will leave him as Plot = true. Now we can save him, place him in an area and 


go. 


NOTE: | have created a mini-script that will remove the glowing exclamation point above a characters 
head. In the database files for this tutorial, you can have a look at it running. The conversation doesn't do 


anything else except remove the exclamation point. 
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Waypoints & Ambient Behaviours 


We are now getting to the polish level of DA development, today we will be looking at Ambient behaviours and part 2 
of the conversations tutorial. Ambient behaviour is the actions that the NPCs perform when the player is not interact- 
ing with them. If you have time, adding ambient behaviour to your creatures can give an area a more realistic feel. 
Ambient behaviour is only triggered if the PC moves within 50m of the NPC and is deactivated after 40s of the player 
moving further than 50m away from them. We will be looking at some basic ambient behaviour if you want to expore 
more complex aspects of ambient behaviour you can look at the wiki: 
http://social.bioware.com/wiki/datoolset/index.php/Ambient behaviour 


Now we are going to load our bob's level again this time we are going to give bob a cat that will wander randomly 
around his room. First we will find a cat creature in the creatures menu | am going to go for. Core Creatures »Ambi- 
ent »house cat once the cat is placed in the level we are going to change its tag to cr bobsCat. now we want to add a 
series of way points around his room for the cat to wander around. First thing to do is to place one at the place where 
you have placed the cat once you have done that go into the properties and change the tag. 


Ambient Walking 


1. Setthe first Waypoint Tag 
+ The ambient walking tag for this first way point will look like this ap cr bobsCat 01 it is made up of 
three important parts. These must be correct for your Ambient walking to work. 
+ gp :theambient move prefix 
+ [creature tag] : your creatures tag, in this case it will be cr bobsCat 
*" [number] : the waypoint number e.g. 01, 02, 03, 04 etc 
2. Create a series of waypoints for your creature to walk 


+ Remember to use the tag series defined above e.g. ap cr bobsCat 01, ap cr bobsCat 02, 
ap cr bobsCat 03, ap cr bobsCat 04 


Hide folders 


3 Core Creatures 
3 Test 
fl cat house (House Cat) 
iJ Ambient 
fl house. cat (Cat 


e" has been checked out 


Only show resources checked out to me 


Object Inspector ax 
(EIH 
Comments ^ 
Group .PC 
MapNote enabled False 
ox 
e" has been saved di 
Name Waypoint 
Tag ap.crbobscat 08 f: 
) Failed. Please see below for more details. & Attributes 
Colour blue 


3. Gointo the creatures variables 


*  Gotothe creatures properties in the object inspector, Variables and click the ... button that appears 
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4. Change the creatures variable values for Ambient move pattern and Ambient move prefix 
* AMBIENT MOVE PATTERN = 4(AMBIENT MOVE RANDOM,, this variable sets the style of ambient 
movement. See the range of ambient move patterns available e.g. loop, patrol, on the wiki: 
http://social.bioware.com/wiki/datoolset/index.php/Ambient behaviour 


+ AMBIENT MOVE PREFIX = ap cr. bobscat, this is the prefix of the waypoints that the creature will 
randomly walk about 


5. Save, export and run, now your cat will walk around. 
* Ifyou are having trouble check that all the tags and variables are correct, the tags must be exact. 
* Once you have it working experiment with different speeds or movement patterns: 
+  1= patrol, 2 = loop, see the full list 
http://social.bioware.com/wiki/datoolset/index.php/Ambient behaviour 
*" running can be activated by multiplying the AMBIENT MOVE PATTERN number by 100 e.g. 
instead of 4 use 400 and see what happens. 


Sitting 
| know many of you want to have NPCs sitting. There are a huge number of animations provided for sitting 


NPCs to get one of these or any of the other looping animations to work you need to set the following vari- 
ables in the NPC: 


e AMBIENT SYSTEM STATE = 2 (means AMBIENT SYSTEM SPAWNSTART, which starts the ambient 
behaviour immediately after spawning) 

e AMBIENT ANIMATION PATTERN = 38 (A normal sitting animation this number is the index of the 
animation in the 2DA file, have a look at the 2DA files on your drive or the Google docs version pro- 
vided on the wiki page http://social.bioware.com/wiki/datoolset/index.php/Ambient_ai.xls [link is 
at the bottom of the section] to see the index of different animations) 

e AMBIENT ANIMATION FREQENCY = -1.0 (this means the NPC will do all the mini animations such 


as looking around etc in the order they are in their animation list, if you want to play with this look 


at the associated section in the ambient behaviour page of the wiki 
http://social.bioware.com/wiki/datoolset/index.php/Ambient behaviour) 


NOTE: If you want to make an NPC sit on a chair the NPC needs to be standing where you want their butt to 


be, so they will usually be standing inside the chair. 
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Bl bobstage 
> Places 

L bob 
pc 


Log Window 


'& close pc 

% closeup bob 
*& default bob 
% default pc 
% wide bob 
*h wide pc 


Conversations Part 2 


Stages 
You will have noticed in our last conversation tutorial that the NPCs just stood around looking bland, to remedy this 


we need to add a stage to our conversation, this will create a record of character and camera locations. 


Go File > New > Stage , create the new resource with a name you will understand and REMEMBER TO PUT IT IN YOUR 
MOD FOLDER, in my case it will be GSTUT/Stages. By default the stage editor should have 4 bview panes if you want 
to change this go to tools > options. For the moment we will leave it how it is, first thing | will do is place an object in 
the scene. Right click > Insert >Place, this is the place holder for one of the creatures (NPCs or PC) in the conversation, 
Place a second "place" and position then close together if they are talking, one will be our PC the other will become 
Bob, if you already know which place is which set the tag up so it makes it easier to set up the stage. 


NOTE: Try to give each place a meaningful tag if you can, you can then tag their cameras with related tags and it will 


make it easier to sort out when the stage starts to get complicated. 


Cameras 
Each place can have up to three cameras which are active when the place character is talking a default shot, wide 
shot and close. Now we are going to set up these shots 


To add a camera to the stage: Right Click » Insert » Camera. Once you have placed it position it approximately then 
choose one of the views right click on its header bar and select the "Selected Camera" option this will set the view to 
seeing as if it were through the selected camera, now you can tweak the "places" and camera to get the shot you 
want. 


NOTE: if you want to see the shot through the camera as it will be in game click the "safe frame" option in the camera 


window it will give you a boxed view that gives you the frame as it will appear in game. 
Create a close up, wide and default camera for each of the places. 


nvo.ere Mi bobstage O1-stg * 


X || Palette Window - All 
$^20995.92 

01 je ^n5oHMezos[mu 

hd 
Only show resources checked out to me 
Hide folders 


3% Cameras 


$9 3 Plot 
HA Scripts 


closeup bob 


User Selected Camera ¡oe 
| Orientation default bob 
| Position default pc 
lg Visualization wide bob 
| Source wide_pc 


ax 


NOTE: for simple scenes ly have to e a default camera. 


Click on the places and give each of the cameras to one of their camera properties: 
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x 


Once you have associated the cameras our stage is complete save it and check it in! 


Now we need to place the stage in our area. 


Go to your area, select your stage from teh stages list = , and place it in your area. Rotate and move the stage till 
one of the places is at the same place and (facing the same way) as bob. 


Open Bob's conversation and check it out. Click on the root of the conversation then go to cinematics tab. The Stage 
section will currently be blank click on it and select the stage you just created. You can now set the association 
between the place and the in game creature, this is where having meaningful tags become important. You can also do 
things like force the players or characters helment off, set their body and head look directions as well as their default 
pose. If you had other place holders for other NPCs you could have the talking characters looking at them or some 
other arrangemen, the stage feature gives you allot of power to control the look and feel of your conversations. 
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€ m Tag [FJ At Current Location | Skip 


v| Seed fi Joverride | ] Lock RoboBrad 
v] [Lock Camera 2nd Camera[ = Delay(s) | 
ps unc a a loded — 
OWNER Yes (Default) X 
pc PLAYER Yes Force Off bob x fault ^25 
j ~ Abomination [=] 
Armcrossed v2 
Arms Crossed 
Arms Crossed Left 
| Arms Crossed Right 
og Window Bartender 
Bear_Sloth 
i) 14:53:31 - tut360con bobsboots.dlg - The resource "tut360con bobsboots.dlg" has been checked out. Bear Sloth Resting 
1i) 14:51:38 - tut300are convo.are - The resource "tut300are convo.are" has been saved. Bl CINE = 


Once you have set up a stage you can generate gestures, if you want to randomly generate the gestures you should 
be able to select the root node then click on the "Generate Poses for 
Children" button. This will theoretically automatically generate gestures 


^. Favs 


Generate Poses for Children 


sutable for a standing man talking to somone. However had trouble ts.dig 
with it | had to select each of the NPC lines and generate the animations = 


for them using the "Generate Gestures for Line" button. 


- IP E HEAR ERE IIA ALA ICAA AAA 


bobstage 01.stg | 4 tut300are_convo.are £- tut360con bobsboots.dlg * | 


Generate Gestures for Line 


B Root 


8 a [[OWNER]] Welcome Traveler, how fares thee? 
¡88 Well thank you and you? 
MB [[OWNER]] Alas not so well. 
EM Is there anything I can do to help? 
E8 ^ J [[OWNER]] I have missplaced my boots, if you would be so kind as to locate them and bring them back to m 
¿88 I will find your boots! [END DIALOGUE] 


ff Sure, because I have nothing better to do... [END DIALOGUE] 
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Now you can go down into the individual lines of conversation and pick the camera you want to use as well as the 
gestures and emotions of your NPCs & PC. 


t v1.0.1008.0 - Game Studio Tute - [tut260con bot 


File Edit View Tools Window Help 
dé kiumoco|v.u5.e»5»uuwweuegcsweH FB o9. DIE E E bx. 
M bobstage_01.stg | d tut300are convo.are C2 tut360con bobsboots.dlg * 


JØ Root 


| & Él Well thank you and you? 


t Ø it just got a whole lot w. now I have to talk to you! 


Jialogue and Scripting | Localization Editing Cinematics Animation | Preview | Slide Show 


Stage Inherit (bobstage 01) Y Tag []At Current Location [E] Skip 
Emotion |happylthinking | Seed | 0 [override E] Lock RoboBrad 


Place Miss Head Look ¡Pose Locked X-Delay Active 
close pc 
bob coseup bob pc (Default) No 
= default_bob — = 
pe default bob Arms Crossed Yes 


Once you have finished tweaking, save all your resources check them in and run the conversation. The faces are still 
very balnd but we have basic animations and customised camera angles. 


Now onto faces! 


If you do there is a few things you will need to do, first you will need to record your voi8ce overs they will need to be 
recorded as or converted to PCM 24 khz 16 bit mono format, otherwise the process will fail and an unhelpful error 
message will be displayed. Once you have done that follow the steps below (from the Wiki): 


Real vo needs to be stored in 

~installpath~\Dragon Age\addins\[moduleuid]\module\override\toolsetexport\[lineid]_m.wav 

- you can dump wav files anywhere under the toolsetexport directory and they will be picked up but for 
organizational purposes you should probably organize it into subfolders grouped by conversation. 


The wav file's filename must be of the form "[lineid]_m.wav" with [lineid] replaced by the ID number for the 
conversation line's string table entry. For example, if a conversation's line ID number is 344169, you'd save the 
voice over for this line as "344169 m.wav". 


When you select "generate vo" from the toolset, the toolset will first check the above directory for properly 
named files. Any wav files that are not present will have robo vo created, and any that do exist will be used 
as-is. 
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A quick way to verify that voice over generation worked after processing: go to ~installpath~\Dragon 
Age\addins\[moduleuid]\core\override\toolsetexport\[conversationname].fsb and play it with windows 
media player. You will hear all of the vo lines for that conversation packaged together with whatever 
combination of real and robo vo all slapped together in one file. 


Note that when you are doing a Builder to player create, you do not need to include the .wav files within the 
package. The sound used by the game is all stored in the .fsb files, and thus including the .wav files will only 
unnecessarily increase the size of mod. 


However if you are testing your VO and facial animation DA:O has a very useful auto VO generation tool. Once you 
have added your VO or if you want to auto generate a demo VO go to Tools »Generate VO »Generate VO to Local, 
after that has generated you can generate Facial animations by going Tools » Generate Face FX » Generate FaceFX to 


Local. This will generate a demo set of facial animations which you can tweak usingt he Tools» Edit Face FX. 


Save it all export it and have a look , the auto generation is a fantastic tool, but | would only use it if you are actually 
going to do the VO as the test voice is a little incomprehensible and doesn't always get the words right. 


If you want more info on any of the parts of conversation building process check out these Wiki Articles: 


e Conversation tutorial - http://social.bioware.com/wiki/datoolset/index.php/Conversation tutorial 


+ Conversation Cinematics & animations: 


http://social.bioware.com/wiki/datoolset/index.php/Conversation cinematics and animation 


e Voice Over: http://social.bioware.com/wiki/datoolset/index.php/Voice-Over 


e Preparing Dialog for recording (Programmers): 
http://social.bioware.com/wiki/datoolset/index.php/Preparing a dialog for recording 
e Face FX: http://social.bioware.com/wiki/datoolset/index.php/FaceFX 


72 


Cutscenes 


Cut-scenes are a huge topic in Dragon Age:O and impossible to cover in our remaining time. | will start with 
a very very very basic cutscene which will simply involve animating a camera. | know that many of you 
would like to use them in your mods | recommend you look at the links below if they are vital for your mod. 


Video Tutorials 


+ Dragon Age Toolset Tutorial 11: Cutscene tutorial, part one: http://youtu.be/ZOQr2Dmx2iU 

+ Dragon Age Toolset Tutorial 12: Cutscene tutorial two: http://youtu.be/ljpCzn1x41M 

+ Dragon Age Origins Toolset Tutorial 14: Cutscene tutorial part 3: http://youtu.be/t8ekbowZ9zg 
+ Dragon Age Toolset - Tutorial 3 - Cutscene + Trigger: http://youtu.be/QOQJ2heQto4s 


Cutscenes in the wiki (links to all the information and documentation on cutscenes) 
http://social.bioware.com/wiki/datoolset/index.php/Cutscene 


First create a new cut scene File » New » Cutscene, once you have added it to the mods file structure, you 
will presented with a screen that looks much like the one you used for staging. Conversations. By default 
you will have 4 view panels open you probably only want two, to change this go to view > Veiwports > two 
(left/right). | generally set one of these up as a top view and the other up as the camera view. By default 
the toolset adds in one camera and a Master (the teal coloured ball), the Master should be placed in the 
centre of the cutscene filming zone as it controls the cameras level of detail drop off so things further away 
are rendered in less detail and it also serves as the main control point for flipping between cameras when 
you have multiple cameras in your cutscene. Now we will need to associate an area with this cutscene, | am 
going to just add bob's room in as a demonstration. Once his room is in we need to move the Master and 


the camera into his room. Once that is done we can start. 


Position your camera how you want it to start, in my case | am starting with a shot of the fireplace. Now 


Camera 1 


below the windows you have a time line here you can key actions, dialogue or whatever you wanted to 
happen in the cutscene. Once we have positioned the camera we will select it in the time line, right click 
and click Key Selection, this will key all the camera's fields, realistically we would probably only need to key 
orientation for what we are doing today but keying all is probably the easiest for the moment. Now we 
want to move down the time line, the time line is currently displaying the number of frames and our 
cutscene is set to 30fps by default, we want our rotation to be slow so we want it to take 20 seconds so we 
move forward to frame 600. Now we change the rotation of our camera to point at the door, if we wanted 
to move it we could, then we select the Camera and Key Selection again. Now we have two key frames. 
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If we were to slide up and down the timer little would happen be- 
cause the default transitions between the key frames is step, we 
want the camera to pan smoothly so we are going to set it to a 
curve or Bezier. We need to do this for the second key frame and 
now drag the marker up and down the timeline the camera rotates. 
To see this in real time we can play the animation using the play 
button in the menu bar. Take the slider back to frame one and 
press play. Look at the animation go. You can now save it and check 
it in. You have created your first cut scene. 


'ames 30/s 0 


& Cut Ctrl -X 
=a Copy Ctrl+C 
X Delete Del 
Select All Ctrl -A 
Clone Actor 
Add Position Key P 
Add Orientation Key O 
Add Camera FOV Key F 
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S + Position 
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Tangent 
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If people want me to | will go further into cutscenes next week, instead of having QA game debugging help 


time. If people decide they need the help time more the links at the begining of this section should help 


you get your cutscenes up and running. 
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Cut Scenes: Part 2 


Ok so last week we did a simple cut scene that involved key framing a single camera movement. This week 
we will create a cut scene where we will begin to use multiple cameras as well as getting NPCs and PCs in- 
volved. 


Once again we are going to use Bob's Conversation area as the setting for out cut scene. We will once again 
set the first camera pointing at the fire, we will rename this camera Fireplace. Now we will add a second 
camera by right clicking in the scene and Insert » Camera. This camera we are going to set looking at bob, 
call this one closeup bob. Then we will add a third looking towards the door, using a similar low angle shot 
as last time, Lowangle door. 


Now we have three cameras in the scene what we want to do is have a shot of the fire, jump to bob's face 
then to the door. We could use key framing with a step transition like last week however if we want to go 
back to bob's close up or the fireplace shot we will have to remember how the shot looked. By swapping 
between pre-positioned cameras we remove that problem. 


Select the beginning of the timeline and go to the MASTER, click on the '*' next to it and then click on the 
property Active Camera: 


'rames 30/s 0 


8 0 20 40 60 80 
MEM N LLI ERN NEN | Object Inspector 


© @ MASTER | Hy 
9 « Position B General 


z *& Fireplace 


Start Time 0 
B Active Camera 


+) à closeup bob 
8 % Lowangle door 


Camera Fireplace 


Ctrl «X 
Ctrl+C 


Cut 
Copy 
Delete 


This is the camera that is Active at that frame, if you 


look at the object inspector you can see that the active 
eye camera is the initial 'Fireplace' Camera. Now go forward 
in the timeline 4 seconds to frame 120. Right click on 
the Active Camera Label under the MASTER and click 


Add Action » Switch Camera. Now you have a new key 


Clone Actor 
Key Selection 
Add Position Key P 
Add Orientation Key O 
Add Track T 
Frames 30/s Add Action 


rry Hide Objects 


* Show Objects 


frame, select it and in the Object inspector select the 


camera closeup bob. go Forward another four seconds 


and do this another time changing the camera to 


3 @ MASTER ae 7 Lowangle door. So far we can pan and switch cameras 
E PN i the next step is to start getting things happening in the 
mmm Properties | "is getting things happening 
9 *« Fireplace cut scene itself. 


4 *& closeup bob 
8 *& Lowangle door 
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Creatures and Cut Scenes 


Now in our area we already had our creature Bob, now by default 
pre-placed objects in an area (objects you placed when building the 
area) are deactivated, this means that they will continue doing their 
preset behaviour and the cut scene has no control over them. This 
can be useful if you have ambient animations that you want run in 


Insert 


the background while a cut scene is running. however we want to 
be able to talk to Bob so to activate him, we need to right click on Select All CUA 
him and select Activate Area Objects. This may take a while de- 
pending on how many objects you have in the area, but once it is -T Properties 

done bob will no longer be blue and you will be able to manipulate 
his behaviour. 


If you didn't want to activate area objects but just wanted to place 
a couple of new creatures, then all you need to do is select them 


from the creature list in the palette window and place them in the 


cut scene the same as you would in a normal area. 


& Cut Ctrl+X 
Ctrl+C 
Del 


Ctri+A 


=3 Copy 
X Delete 
Select All 


Once the creature is places or activated a number of new options will be visible in 
the object inspector window, have a look at it now. 


If you look down the list you can see you have the option of setting the NPCs ar- Frames 3 clone -= B 
mour and arms to visible or not. Much like the turn of helmet option in the con- ME = Oa y 
versation stage options. You also have the ability to set the NPC's pose such as 50 mi Add Gestion 6 
crossed arms or sitting, you can also set a previous pose, speed and transition E G FUIT 1] 
delay. i Hide Objects 

a Fit) w^ Show Objects 
Now what we want to do is set it up so bob actually can do something. First thing a M dd Markers > 
we will need to do is right click on Bob on the right hand side of the time line - "E Properties 
and select Add Track. This will add a new track for the creature that you can add 
behaviours to. In this case we will right click this track click Add Action > Play 


Animation (see pic next page). Now you can 


=a Copy Ctrl+C 
drag this along the time line and set it up to X Delete Del 
where you want it to. | am going to add a new Select All Ctrl -A 
camera which gives us a wide angle shot of bob Frames 30/s Clone Actor 
and set up the animation in that shot. Once you m e | = Key Selection K fe " in "T W 
— ER | 11 LETLIT MN MN 
have set up the new camera, wide bob, and set a + Posit Add Position Key p 
up the master to switch to it, at around 300 m m 
: : : 3 * Firepl Add Track T 
frames, move the animation to the same time n irep Ro rm S " Animate Face 
frame . Once you have done that look at the an- EN dosein E ^ Change Visibility Alt«I 
a% Lowang Hide Objects 
imation properties in the object inspector. Click 5 Bob |M Show Objects nia - 
AL: T 
on the Animation property and then on the ... a P Posi — Markers , bigis. 
: li fth . . | C Ori Link to Actor Alt«L 
+ rien i 
button. Here is a list of the animations. Currently x ¡el Properties R NE 
this list is fairly useless but if you use it in con- : [New Track] - Le = Play Animation AltA 
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ake (Fosition 


4 
| (4) Log Window Bookmarks Console | (i Speak Line 


we a A 


php/Animation list) you can work out which ones you want. Please note that this list does not contain all 


the available animations and some of the animations on this list aren't in the editor for bob. 


| am going to select mh.dg tk sad, now you can see Bob's sad animation. You can now add another track 
to bob and add a second animation, | am going to use mh.wi squat en. Now what we want to do is get one 
animation to transition into the other. Move the second animation so it has a decent overlap with the first. 
Select both the animations right click and select add Transition. 
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You can now set the transition in the object properties window. In this case | will set it to Ease InOut. Now 
if you run the slider along the timeline the animations will bleed into one another. Some animations don't 

blend well so you may have to experiment with different ones when you are setting up your scene. So you 

now have Bob animating and cameras moving... Now we need to get him to speak. 


To get a conversation happening you need to make sure you already have a conversation created with 


voiceovers and facial animations exported (see last weeks tute). | am just going to use a line from the Bob's 


boots quest conversation. To start with we need a new track so give bob a new track, then right click on it 
and instead of adding a new animation Add a Speak Line. Once you have done with select the line and look 
at the object properties. Click on Source conversation and select the conversation you want, in this case I 
will use the Bob's quest dialogue | have already created. Next you need to select the line of dialogue for 
him to speak, click on source line and select it from the drop down list. The toolset automatically connects 
the conversations already exported voice over and facial animations so your NPC is now speaking. 


Adding the Player 

To add the player to your cut scene you first need to add a placeholder creature, | am just going to put in 
the Mordred character | made a few weeks ago, but any will do you might want to create a custom dummy 
character that you use in all your cut scenes so you always know which one the player is. Now he is in, we 
need to position him the way we want him then scroll down his properties and set the Mapping tag to 
PLAYER. | would also recommend forcing the helmet off and possibly the gloves if you want to involve the 
PC in a conversation. Now we can add animations to the PC just as we did with the NPC. Now we are going 
to get the PC to walk in from the door. Take the scene back to the shot of the door and make sure the PC is 
there. Now add a new animation to the pc, mh.dg f 5p, this is a walking on the spot animation. Start the 
animation just before the camera gets to the PC so it looks like the camera caught the PC mid walk. Now we 
need to get the PC moving first we need to add a starting key frame so right click on the PC placeholder and 
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Key selection, like we did with the camera last week. Now we add another track this one forcing the PC to 


snap to the walk mesh. 
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Now select the Snap to Walkmesh's properties 
and set Infinite to true. Once that is done click 
on the walking walk cycle and turn on GAD, 
Gad is the displacement to the players current 
position as an animation plays (see 
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now to create a cut scene, set up camera ani- 
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volved. It is now up to you to use these tools to really polish and develop good cut scenes. 


Trigger a cutscene using a trigger 
So now we have the cut scene built lets go back to our area and set up a trigger. Create a new trigger script 
that contains this code: 


#include "log h" 
#include "utility h" 
#include "wrappers h" 
#include "events h" 


void main() 


{ 


event ev = GetCurrentEvent(); 
int nEventType = GetEventType (ev) ; 
string sDebug; 


Log Events("", ev); 


switch (nEventType) 


{ 
case EVENT TYPE ENTER: 


{ 
CS LoadCutscene (R"cutscenetut part2.cut"); 
PlayCutscene(); 
break; 


} 
} 


Create a new trigger (file > new > trigger) and instead of the script trigger_core give it your new script. 
Save it and check it in. Draw your trigger in front of the door/over the spot where the player loads, so that 
the cut scene is triggered as soon as they enter. Now save all you resources export an run the game. The 
cut scene not runs when you enter the area. Note the PC snaps back to their position at the end of the cut 


scene, be aware of that when setting yours up. 


NOTE: a more elegant and preferable solution to trigger a cut scene on level load would be to place the 


script in the level load script. 


So there you have it you can create a cut scene and trigger it. the rest is up to you. There are a huge num- 
ber of resources on cut scenes on the wiki. If you are making cut scenes | recommend you look through the 
resources on the wiki and watch the online videos | provided links to last week. 
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